chore: switch default postgres host port to 5434

memory/2026-05-01.md

@@ -61,3 +61,31 @@
 - 风险与影响：
   - 生产发布入口从 `main` 切换到 `dev`，需确认团队分支策略已同步。
   - `workflow_dispatch` 若在非 `dev` 分支触发，deploy job 会被 `if` 条件跳过。
+
+## Work Log - 修复 docker db 端口 5433 冲突并改为 5434（2026-05-01）
+
+- 背景：
+  - `docker compose` 启动 `db` 报错：`Bind for 0.0.0.0:5433 failed: port is already allocated`。
+  - 现有默认口径为宿主机映射 `5433->5432`，与本机已占用端口冲突。
+
+- 本次改动（最小闭环）：
+  - 文件：`docker-compose.yml`
+    - `db.ports` 默认映射从 `${POSTGRES_PORT:-5433}:5432` 改为 `${POSTGRES_PORT:-5434}:5432`。
+  - 文件：`.env.example`
+    - `POSTGRES_PORT` 默认值从 `5433` 改为 `5434`。
+    - 本机直连 `DB_PORT` 默认值从 `5433` 改为 `5434`。
+  - 文件：`api/app/core/config.py`
+    - `db_port` 默认值从 `5433` 改为 `5434`，与环境模板和 compose 默认保持一致。
+  - 文件：`README.md`
+    - 本地 PostgreSQL 示例端口从 `localhost:5433` 更新为 `localhost:5434`。
+  - 文件：`MEMORY.md`
+    - 宿主机默认 `POSTGRES_PORT` 与本机直连 `DB_PORT` 长期口径同步更新为 `5434`。
+
+- 验证：
+  - `POSTGRES_PORT=5434 docker compose up -d db` -> `fquiz-db` 启动成功。
+  - `docker compose ps -a` -> `fquiz-db` 状态 `Up ... (healthy)`。
+  - `docker inspect fquiz-db --format '{{json .HostConfig.PortBindings}}'` -> `5432/tcp` 映射 `HostPort=5434`。
+
+- 风险与影响：
+  - 影响范围：本地/部署侧依赖默认 `5433` 的连接配置需同步为 `5434`，否则会出现连接失败。
+  - 容器内服务间连接不受影响，仍通过 `db:5432` 通信。