eip4dev: 构建本地开发库,日常开发完全脱离 5435
- tools/local-devdb/build_devdb.sh: 幂等构建脚本,分层 dump/restore (ACT_* schema-only / 超500MB巨表 schema-only / 其余全量), 内置 5435/ceshi 库安全守门,参数化源/目标/阈值/巨表清单 - tools/local-devdb/sql/data-tables.txt: 必须全量的引擎元数据/组织表清单 - tools/local-devdb/本地开发库构建报告.md: 实跑报告(2738MB/345s/94.1%对拍通过) - application-dev.yml: dev profile 指向 localhost:5433/eip4dev,端口 8093 - README.md: 补三套 profile 说明(dev/local/默认)及常用命令 - SysUserService.java: 修复 MASTERDEPART 列不存在导致登录 500 的 bug - docs/迁移手册.md: 追加三条新坑位(MASTERDEPART/sys_page_schema/shell 中文变量名) 验证: 登录 OK / list(1079行) / picker(5条) / ParityCli 1166实体 803 OK_FULL+294 OK_SAMPLE 完全本地: pg_stat_activity 全部连接来自 127.0.0.1:eip4dev,无 5435 连接 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
40
docs/迁移手册.md
40
docs/迁移手册.md
@@ -769,4 +769,44 @@ com.dsasp.* com.eip4.*
|
||||
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
## 十、本地开发库 eip4dev 坑位台账 [NEW 2026-06-11]
|
||||
|
||||
### 10.1 SYS_USER 表缺 MASTERDEPART 列
|
||||
|
||||
**现象**:dev profile 启动后调用 `/api/auth/login` 返回 500,日志报 `column "masterdepart" does not exist`。
|
||||
|
||||
**根因**:`SysUserService.java` 的 SQL 中查询了 `MASTERDEPART` 列,但侦察源库 5435 及本地 eip4dev 均无此列(sys_user 实际只有 14 列)。该列名来自早期代码中对 eip4m0 自举库的假设。
|
||||
|
||||
**对策**:已修复 `SysUserService.java`,SQL 去除 `MASTERDEPART`,RowMapper 中 `depart` 字段固定为 null。
|
||||
|
||||
**影响范围**:platform-auth 模块登录路径;`AuthPrincipal.depart()` 在实际库中始终为 null,下游若依赖此字段需注意。
|
||||
|
||||
---
|
||||
|
||||
### 10.2 sys_page_schema 表在 eip4dev 中不存在
|
||||
|
||||
**现象**:`GET /api/page/schema/{id}` 返回 `{"status":2,"msg":"schema 存储不可用"}`。
|
||||
|
||||
**根因**:`sys_page_schema` 是 eip4-platform 新增表(非客户库原有),在 eip4dev dump/restore 时不存在于源库,因此目标库也没有该表。
|
||||
|
||||
**对策**:需在 eip4dev(及所有目标库)中手动建表。建表 SQL 位于 `platform-metadata` 模块的 schema 迁移脚本(待补)。这是已知 gap,不影响引擎元数据/list/picker 等主路径验证。
|
||||
|
||||
**影响范围**:page schema 存储相关接口;其余接口不受影响。
|
||||
|
||||
---
|
||||
|
||||
### 10.3 build_devdb.sh 中变量名后紧跟中文字符导致 unbound variable
|
||||
|
||||
**现象**:早期版本脚本运行报 `unbound variable`,类似 `$PG_VER(` 被 bash 解析为含多字节字节的变量名。
|
||||
|
||||
**根因**:bash 不识别 UTF-8 多字节边界,中文全角括号 `(` 的首字节(0xEF)被当作变量名的一部分,导致 `$VAR(...)` 形式的 log 字符串在 `set -u` 下报错。
|
||||
|
||||
**对策**:所有 shell 脚本中,`$VAR` 后若紧跟中文,必须用 `${VAR}` 花括号保护,或将中文括号改为 ASCII `()`。已在 `build_devdb.sh` 中全面修复并用 Python 扫描验证无遗漏。
|
||||
|
||||
**影响范围**:所有含中文注释/log 的 shell 脚本;CI 环境若 LANG 不同可能提前暴露此问题。
|
||||
|
||||
---
|
||||
|
||||
**手册维护说明**:本手册随工程化进展持续更新;新坑位发现即追加,以 `[NEW yyyy-mm-dd]` 标记;章节完成后移除「待补」标记。任何对引擎行为契约的更改必须同步更新第五章并过 code review。
|
||||
|
||||
Reference in New Issue
Block a user