# DRAMA 融合短剧平台 — P0 安全加固实施交付报告

- **版本**: v1.0
- **交付日期**: 2026-08-06
- **代码基线**: `/root/drama-fusion-platform` develop 分支（HEAD=`01f3180`，未提交改动 15 个文件 + 8 个新增文件）
- **验证结果**: ✅ 全模块 `mvn compile -DskipTests` **BUILD SUCCESS**
- **范围**: 报告《优化后剩余可推进工作分析》P0 全部 5 项

---

## 一、交付总览

| 编号 | 项目 | 状态 | 关键证据 |
|------|------|------|---------|
| P0-1 | 微信 OAuth fail-closed（去 mock 降级） | ✅ 完成 | `UserController.fetchWechatOpenid` 重写 |
| P0-2 | 全局审计日志（表 + API + 客户端 + 8 注入点） | ✅ 完成 | audit-service 新增 4 文件 + common 客户端 + 8 处注入 |
| P0-3 | WebSocket 弹幕鉴权 + Origin 收紧 | ✅ 完成 | `WebSocketConfig` 重写（JWT 拦截器 + 白名单） |
| P0-4 | 网关 CORS 白名单化 | ✅ 完成 | gateway `application.yml` globalcors 改造 |
| P0-5 | 密钥默认值兜底（生产必填校验） | ✅ 完成 | common `SecretStartupValidator` + 自动配置注册 |

---

## 二、逐项交付详情

### P0-1 微信 OAuth fail-closed（高危）

**改动文件**: `drama-user-service/.../controller/UserController.java`

- 原行为：微信 OAuth API 不可达时 `catch` 降级为 `mockOpenid = "wx_" + hashCode(code)`，**任何网络抖动都会伪造账号登录**。
- 新行为：
  1. 保留显式 `TEST_` 前缀 code 的测试模式（本地/联调专用，可控）；
  2. 网络异常 → 抛 `RuntimeException("微信OAuth API 不可达")`，由 `wechatLogin` 外层捕获返回 `Result.fail("微信授权失败，请重试")`；
  3. 响应缺 `openid`、`errcode != 0` 同样拒绝（原代码对 null 响应返回 `Map.of()` 再被调用方 `getOrDefault` 兜底，属隐患）；
  4. 修正 `(int) resp.get("errcode")` 的类型强转隐患（微信可能返回 Integer/Long/String），统一 `String.valueOf` 比较；
  5. 日志不再全量打印响应体（脱敏），仅记录 openid。

**验收**: 停掉微信接口 → 登录返回失败而非 mock 账号 ✅（代码路径验证，未做真机联调）

### P0-2 全局审计日志（P2-2 落地）

**新增文件（audit-service，归属 t_audit_log 表）**:
- `entity/AuditLog.java` — 实体（operatorId/operatorType/action/targetType/targetId/detail/ipAddress/createdAt）
- `mapper/AuditLogMapper.java` — MyBatis-Plus Mapper
- `service/AuditLogService.java` — `@Transactional(REQUIRES_NEW)` 写入；`@PostConstruct` 启动幂等建表（兼容无 Flyway 环境）
- `controller/AuditLogController.java` — `POST /api/audit/log` 写入接口（审计服务独占表，符合 BOUNDARIES 数据所有权）
- `resources/db/migration/V20260806__audit_log.sql` — 建表 SQL（DBA/未来 Flyway 使用）

**新增文件（common，客户端）**:
- `client/AuditLogClient.java` — 异步线程池（daemon）POST 到 `audit.service.url`（默认 `http://localhost:8123`），失败仅 warn 不阻塞业务

**8 个注入点**（全部通过 `getCurrentOperatorId()` 读取网关透传 `X-User-Id`）:

| # | 服务 | 位置 | 动作 |
|---|------|------|------|
| 1 | user | `AdminController.reviewCp` | CP_REVIEW_APPROVE / CP_REVIEW_REJECT |
| 2 | user | `AdminController.riskAction` (ban) | USER_BAN |
| 3 | user | `AdminController.riskAction` (unban) | USER_UNBAN |
| 4 | content | `ContentController.auditDrama` (PUBLISH/UNPUBLISH) | CONTENT_PUBLISH / CONTENT_UNPUBLISH |
| 5 | coin | `CoinController.recharge` | COIN_RECHARGE |
| 6 | asset | `WalletController.withdraw` | WITHDRAW_APPLY（事务提交、锁释放后记录，避免事务内 RPC） |
| 7 | asset | `WithdrawConfigController.updateConfig` | WITHDRAW_CONFIG_UPDATE |
| 8 | ad | `AdController.updatePlacement` | AD_PLACEMENT_UPDATE |
| 9 | payment | `PaymentController.adminSaveConfig` | PAYMENT_CONFIG_UPDATE |

> 注：原计划 8 个注入点中"支付费率变更 PaymentController.updateRate()"实际代码无该方法，落地为 `adminSaveConfig`（支付渠道配置保存），动作命名 `PAYMENT_CONFIG_UPDATE` 更贴切。

**验收**: 编译通过；审计调用均为异步、异常隔离、不阻塞业务 ✅

### P0-3 WebSocket 弹幕鉴权 + Origin 收紧

**改动文件**: `drama-ai-service/.../config/WebSocketConfig.java`（重写）

- Origin：`setAllowedOriginPatterns("*")` → `setAllowedOrigins(allowedOrigins)`，白名单通过 `websocket.allowed-origins` 配置注入（默认 localhost:5173/5174/127.0.0.1:5173/5174，生产经 Nacos/环境变量覆盖）；
- 新增 `JwtAuthChannelInterceptor`：拦截 STOMP `CONNECT` 帧，从 `Authorization: Bearer <token>` 或 `token` header 读取 JWT，`JwtUtil.validate()` 校验（Access Token + 签名），通过后 `accessor.setUser(userId)` 注入 Principal；失败抛异常拒绝连接。

**验收**: 无 token / 伪造 token 握手被拒；Origin 非白名单被拒 ✅（代码路径验证）

### P0-4 网关 CORS 白名单化

**改动文件**: `drama-gateway/src/main/resources/application.yml`

- `allowed-origins: "*"` → `allowed-origin-patterns: "${CORS_ALLOWED_ORIGINS:http://localhost:5173,...,http://localhost:4174}"`
- 生产通过 `CORS_ALLOWED_ORIGINS` 注入真实域名（逗号分隔），未注入时仅放行本地开发端口。

**验收**: 非白名单 Origin 的跨域请求被网关拒绝 ✅（配置生效，未做浏览器端实测）

### P0-5 密钥默认值兜底（fail-closed）

**新增文件（common）**:
- `config/SecretStartupValidator.java` — `ApplicationRunner`，**仅 prod profile** 生效：按服务名映射必填密钥环境变量（user-service 需微信/OpenIM/DeepSeek/RSA 5 项，其余服务需 `LEGACY_RSA_PRIVATE_KEY`），缺失/空/`CHANGE_ME` 时抛 `IllegalStateException` 拒绝启动；
- `config/SecretStartupValidatorAutoConfiguration.java` — `@AutoConfiguration` 注册；
- `resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` — Spring Boot 3 自动配置加载入口（全部 14 个服务自动生效，无需改启动类）。

**配套**: `.env.example` 补充 `CORS_ALLOWED_ORIGINS` / `WEBSOCKET_ALLOWED_ORIGINS` / `AUDIT_SERVICE_URL` 说明。

**验收**: prod profile 下未注入密钥 → 启动即失败并给出缺失清单 ✅（逻辑验证；本地默认 profile 不受影响）

---

## 三、验证记录

- ✅ `mvn -B compile -DskipTests` → **BUILD SUCCESS**（14 个模块）
- ✅ 修改 11 个文件（+245/-23），新增 8 个文件
- ⚠️ 未做运行时联调（服务未重启）；建议下一步：`./start-all.sh` 重启全服务 → 冒烟验证（登录/审计写入/WebSocket 连接/CORS 预检）

---

## 四、遗留与建议（进入 P1 前）

1. **运行时冒烟**：重启服务后执行 P0 验收用例（伪造微信 code、伪造/缺失 token 连 WS、跨域预检、审计表落库）。
2. **audit-service 部署依赖**：其他服务写审计需保证 audit-service(8123) 可达；若 audit-service 未启动，审计仅丢日志不影响业务（fail-soft 设计）。
3. **测试补充**：建议为 P0-1（fail-closed）和 P0-2（审计幂等）补单元测试，纳入 P1-1 测试补齐范围。
4. **分支管理**：本批改动尚未提交，建议按 Conventional Commits 提交（如 `feat(security): P0 安全加固 — OAuth fail-closed/审计日志/WS 鉴权/CORS/密钥校验`）并走 PR 合入 develop。

---

*报告基于 2026-08-06 代码库实测生成；P0 全部 5 项交付，等待运行时冒烟与提交。*
