暂存提交

2026-07-31 11:25:15 +08:00
parent a9abd07105
commit 9fb7676bf6
19 changed files with 175 additions and 0 deletions
@@ -0,0 +1,67 @@
+# 数据库环境切换说明
+
+## 环境定义
+
+- `dev`：本地开发环境，连接 `127.0.0.1:3306`，默认账号为 `root/123456`。
+- `test`：联调测试环境，连接 `8.163.30.128:3306`，各微服务仍使用独立数据库。
+
+所有服务默认使用 `dev`：
+
+```yaml
+spring:
+  profiles:
+    active: ${SPRING_PROFILES_ACTIVE:dev}
+```
+
+建议不要直接修改配置文件。通过 IDEA 的启动配置设置 `Active profiles` 即可切换：
+
+- 本地数据库：`dev`
+- 测试数据库：`test`
+
+也可以使用启动参数：
+
+```text
+--spring.profiles.active=test
+```
+
+## 测试数据库密码
+
+测试数据库密码不写入 Git。启动 `test` 环境前，在 IDEA 启动配置的环境变量中设置：
+
+```text
+TEST_DB_PASSWORD=测试数据库密码
+```
+
+公共测试连接参数支持覆盖：
+
+```text
+TEST_DB_HOST=8.163.30.128
+TEST_DB_PORT=3306
+TEST_DB_USERNAME=root
+TEST_DB_PASSWORD=测试数据库密码
+```
+
+每个服务还支持使用自己的 `*_TEST_DB_URL`、`*_TEST_DB_USERNAME` 和 `*_TEST_DB_PASSWORD` 覆盖公共参数。
+
+## 分库映射
+
+| 服务 | 测试数据库 |
+| --- | --- |
+| 认证服务 | `baiyue_auth` |
+| 权限服务 | `baiyue_iam` |
+| 订单服务 | `baiyue_order` |
+| 仓库服务 | `baiyue_warehouse` |
+| 头程履约服务 | `baiyue_firstleg` |
+| 文件服务 | `baiyue_file` |
+| 打印服务 | `baiyue_print` |
+| 审计服务 | `baiyue_audit` |
+| 事件桥接服务 | `baiyue_event_bridge` |
+
+网关和集成服务没有业务数据库，但同样支持 `dev/test` Profile。网关在两种环境下都会自动加载 `cn` 路由配置。
+
+## 注意事项
+
+- `test` 只切换数据库，Nacos 和 Redis 默认仍连接本机。
+- 环境变量优先级高于配置文件，可用于临时覆盖单个服务。
+- 修改 IDEA 环境变量后需要重启对应服务。
+- 不要把测试数据库密码提交到配置文件、启动脚本或 Git。