hl-api-changelog/changelogs/2026-05/05_fix_gateway_wx-security_route_404.md

修 admin wx-security 6 接口全 404 — 网关路由白名单缺项

日期: 2026-05-05 类型: fix（网关路由配置补漏，无前端影响） PR: wx/HL #1679（已合并到 dev） 关联工单: #1678 关联 PR: #1668（Phase 2D admin 后台，未同步改 gateway）/ #1669 / #1675

背景

PR #1668 新增 6 个 admin wx-security Controller (AdminWxSecurityHitLogController / Blacklist / Whitelist / ManualReview / Avatar / UserRisk),但 0 改动 hl-gateway/src/main/resources/application.yml。后续 PR #1669 / #1675 也未补。测试服 nacos hl-gateway-*.yml 三 dataId 全 not exist,gateway 完全靠 jar 内 yml,导致 /admin/wx-security/** 6 接口在 gateway 兜底层全部 404。

mmg 同事从 hl-ui-admin (https://localhost:9527) 走 vue.config.js proxy → 测试服 https://api.test.1814.love:9443 网关时暴露,backend 单测/本地 8081 直连验收均无法发现。

铁证

• 故障接口 HTTP 404 + body 是 Spring Boot 默认 5 字段格式 ({"timestamp","path","status","error","requestId"}),无 code 字段 → gateway 兜底,不是 controller
• 兄弟 /admin/sys/dict/all 返回 {"code":401,"message":"..."} → user-service 在线、controller 正常
• git show e90a7dd6 --stat(PR #1668) 0 涉及 hl-gateway/

修复

hl-gateway/src/main/resources/application.yml 在 line 138 后插入 4 行新路由(+ 1 行注释,共 +5):

        # 微信内容安全 admin 端 (黑/白名单/命中日志/人工复审/头像/用户风险 6 controller, PR #1668)
        - id: admin-wx-security-service
          uri: lb://hl-user-service
          predicates:
            - Path=/admin/wx-security/**

一条 Path predicate 覆盖 6 个 controller,无需 metadata。

影响范围

• 受波及接口: wx-security admin 全部 6 个 controller (HitLog/Blacklist/Whitelist/ManualReview/Avatar/UserRisk)
• mp 端 /mp/security/** 不受影响(line 50-53 早有 Path predicate)
• 数据污染: 无(请求未到达 service / DB)
• 回滚: 不需要(前向修复即可)

部署 + 验证

需运维/管理员在 Deploy Panel 触发 hl-gateway 部署 dev 分支,redeploy 完成后 round-trip 6 接口:

TOKEN="<admin token>"
for path in hit-log/page blacklist/page whitelist/page manual-review/page avatar/page user-risk/page; do
  curl -k "https://api.test.1814.love:9443/admin/wx-security/$path?page=1&pageSize=10" \
       -H "Authorization: Bearer $TOKEN" -w "\nHTTP=%{http_code}\n\n"
done

验收标准: 6 接口都返回带 code 字段的 Result body (HTTP 200, code 0/200 数据正常 或 401 鉴权)。

经验沉淀

落 memory/experience/backend-dev/admin-controller-without-gateway-route-cascade-404.md — 同模式踩坑 PR #1048 / #1293 / #1668 三连发,从未沉淀。3 秒辨识法: 响应 body 无 code 字段 = gateway 兜底,直接锁配置不必深挖代码。

强化 memory feedback_api-test-must-go-through-gateway.md cadence: 凡新增 /admin/<新模块>/** 类 controller,API 验收必经 9443 网关,user-service 直连 8081 单测全绿不算数。

通知

• @mmg: 网关路由已补,等运维部署 dev 后 hl-ui-admin 9527 → 9443 proxy 链路即恢复,所有 wx-security admin 页面可正常访问
• 后端无前端改动需求,前端不用动