修改端口号

在微服务架构中，每个服务实例需要通过独立的端口进行通信。若需修改某个服务的监听端口，请按以下步骤操作：

1. 定位配置文件

   • 进入目标服务的工程目录。

   • 打开 src/main/resources/ 路径下的 application.yml 核心配置文件。

2. 修改端口配置

   • 在配置文件中找到或新增 server.port 属性节点。

   • 为其分配合适的端口号（建议在规划范围内选择，避免冲突）。

配置示例：

# 服务配置
server:
  # 端口
  port: 8081

注意事项

端口冲突：确保修改后的端口在当前运行环境中未被其他服务占用。

多环境配置：若项目区分环境（如 dev, test, uat，prod），需在对应环境的配置文件（如 xiaomayi-admin-biz.yml）中覆盖该配置，或在主配置中通过 spring.profiles.active 指定环境生效。

动态配置：若项目使用配置中心（如 Nacos），可能需在中心修改并发布相应配置，重启服务或等待配置热刷新。

上传附件路径

• 问题现象

  本地图片上传功能失败，控制台可能提示附件目录无法访问或路径错误。

• 问题原因

  该问题通常是由于未正确配置附件存储目录 upload 的绝对路径所致。服务无法在服务器本地找到或创建有效的文件存储目录。

• 解决方案

  请通过 Nacos 配置中心修改对应环境的服务配置文件，具体操作步骤如下：

  1. 登录控制台

     访问您的 Nacos 服务器地址，并使用相应账号登录。

  2. 定位配置文件

     • 在左侧菜单选择正确的 命名空间 (Namespace)，确保环境（如 dev、test、prod）与您要修改的服务环境一致。

     • 找到并点击目标服务的配置文件，例如：xiaomayi-admin-biz.yml。

  3. 修改文件上传路径

     在配置编辑器中，找到或添加文件上传相关的配置项。通常，这涉及设置一个本地绝对路径。

     # 系统配置
     system:
       # 软件名称
       name: 小蚂蚁云
       # 软件版本
       version: 2.0.0
       # 本地存储路径
       profile: F:\xiaomayi\upload\
       # 本地资源访问域名
       domain: http://127.0.0.1:9010/api/admin/file
       # 演示环境
       demo: false

附件路径

上述配置中 profile 是本地附件存储目录绝对路径参数，本地部署时请填写正确的 upload 附件绝对路径。

附件域名设置

• 问题现象

  本地附件上传后，文件路径无法访问。

• 问题原因

  该问题通常是由于未正确配置附件访问域名导致，需正确配置域名指向附件存储目录 upload 目录。

• 解决方案

  请通过 Nacos 配置中心修改对应环境的服务配置文件，具体操作步骤如下：

  1. 登录控制台

     访问您的 Nacos 服务器地址，并使用相应账号登录。

  2. 定位配置文件

     • 在左侧菜单选择正确的 命名空间 (Namespace)，确保环境（如 dev、test、prod）与您要修改的服务环境一致。

     • 找到并点击目标服务的配置文件，例如：xiaomayi-admin-biz.yml。

  3. 修改文件上传路径

     在配置编辑器中，找到或添加文件上传相关的配置项。通常，这涉及设置一个本地绝对路径。

     # 系统配置
     system:
       # 软件名称
       name: 小蚂蚁云
       # 软件版本
       version: 2.0.0
       # 本地存储路径
       profile: F:\xiaomayi\upload\
       # 本地资源访问域名
       domain: http://127.0.0.1:9010/api/admin/file
       # 演示环境
       demo: false

附件域名

配置项中的 domain 参数用于设置系统的文件访问域名。该域名是提供给前端应用程序用于拼接和访问所有已上传文件（如图片、文档等）的完整URL地址基础。

• 配置代理服务

为使 domain 域名正确指向服务器本地的附件资源，必须在 Nginx 中进行代理配置，将请求转发至实际的附件目录。

1. 本地解析

以 Windows 11 为例，在 C:\Windows\System32\drivers\etc 目录下找到 hosts 文件，输入以下内容：

127.0.0.1 image.example.com

2. 配置示例

server {
  listen 80;
  server_name image.example.com;
  root E:\xiaomayi\upload\;
  location ~ \.ico|jpg|JPG|PNG|GIF|JPEG|jpeg|gif|png|js|css|woff2|ttf$ {
    add_header Access-Control-Allow-Origin *;
    add_header Access-Control-Request-Methods GET,POST,PUT,DELETE,OPTIONS;
    #expires 1h;
  }
}

重启服务

配置图片域名 nginx 配置文件后，需重启本地 nginx 代理服务。