qihang-ecom-erp-open/api/erp-api/src/main/resources/nacos

Nacos 配置说明（erp-api）

与 Yunxi 工程（如 yundt-boot-center-maindata-aggboot）对齐：命名空间 hbxhzt-test、共享 yundt-cube-common.yaml、服务注册名 erp-api（供 maindata Feign 调用）。

本地 / 默认启动（当前仓库约定）

bootstrap.yml 中已将 Nacos Config 与 Discovery 固定为 enabled: false，不连 Nacos，仅使用 application.yml（及 classpath 下其它本地配置）。

注意：若进程环境中存在 SPRING_CLOUD_NACOS_CONFIG_ENABLED=true 或 SPRING_CLOUD_NACOS_DISCOVERY_ENABLED=true（Spring 标准绑定），会覆盖 yml 仍为开启；本地纯配置时请删除上述变量或设为 false。旧版脚本若曾使用 NACOS_CONFIG_ENABLED，请改为不再导出或对齐 Spring 变量名。

UAT / K8s 启用 Nacos

在启动命令中显式打开（覆盖 bootstrap 中的 false），例如：

--spring.cloud.nacos.config.enabled=true
--spring.cloud.nacos.discovery.enabled=true

并设置：

变量 / 配置	说明
NACOS_SERVER_ADDR	如 nacos-headless.hbxhzt-test.svc:8848
NACOS_NAMESPACE	与控制台一致，默认 hbxhzt-test
NACOS_CONFIG_FAIL_FAST	UAT 建议 true
NACOS_USERNAME / NACOS_PASSWORD	Nacos 开启鉴权时

可选：NACOS_REGISTER_ENABLED=false 仅拉配置不注册。

上传 erp-api.yaml

1. Nacos 控制台 → hbxhzt-test 命名空间 → 配置管理。
2. 新建：
   • Data ID：erp-api.yaml
   • Group：DEFAULT_GROUP
   • 格式：YAML
   • 内容：复制本目录 erp-api.yaml，按环境改库、Redis、external.auth（须与 maindata ErpOpenProperties 一致）。
3. 同一命名空间下需已存在 yundt-cube-common.yaml（与兄弟工程共用）。

maindata 调用说明

• 注册服务名：erp-api（即 spring.application.name）。
• 端口：38083（在 erp-api.yaml 的 server.port 中配置）。
• HTTP 路径：例如 /external/goods/upsert；若经网关，按网关路由配置。
• 鉴权：/external/** 仍为 AK/SK 签名，与 external.auth 及 maindata 侧密钥一致。