From 470096aa9a79724e7e4ce0819528c876f5eff0e3 Mon Sep 17 00:00:00 2001 From: hongawen <83944980@qq.com> Date: Fri, 15 May 2026 13:38:06 +0800 Subject: [PATCH] =?UTF-8?q?feat(gateway):=20=E4=BF=AE=E6=94=B9=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E4=B8=8A=E4=BC=A0=E6=8E=A5=E5=8F=A3=E8=BF=94=E5=9B=9E?= =?UTF-8?q?=E7=BB=93=E6=9E=84=E5=B9=B6=E6=B7=BB=E5=8A=A0=E8=AE=A4=E8=AF=81?= =?UTF-8?q?=E8=B7=AF=E5=BE=84=E7=99=BD=E5=90=8D=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将 POST /system/file/upload 接口返回结构从字符串改为 { id: string, url: string } 对象 - 添加 id 字段作为 infra_file.id 的字符串形式，解决前端精度丢失问题 - 新增 SKIP_AUTH_PATHS 白名单集合，包含登录、登出、刷新令牌等免校验路径 - 在网关过滤器中添加白名单检查逻辑，跳过指定路径的 access token 校验 - 解决过期 token 拦截导致刷新令牌接口无法正常执行的问题 --- .../security/TokenAuthenticationFilter.java | 18 ++++ .../2026-05-11-file-upload-api-改造需求.md | 98 ------------------- 2 files changed, 18 insertions(+), 98 deletions(-) delete mode 100644 rdms-system/2026-05-11-file-upload-api-改造需求.md diff --git a/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java b/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java index b8c5380..00eed22 100644 --- a/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java +++ b/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java @@ -25,6 +25,7 @@ import reactor.core.publisher.Mono; import java.time.Duration; import java.util.Objects; +import java.util.Set; import java.util.function.Function; import static com.njcn.rdms.framework.common.util.cache.CacheUtils.buildAsyncReloadingCache; @@ -37,6 +38,18 @@ public class TokenAuthenticationFilter implements GlobalFilter, Ordered { private static final LoginUser LOGIN_USER_EMPTY = new LoginUser(); + /** + * 跳过 access token 校验的路径白名单。 + * 这些接口在 system 端标注 @PermitAll，本就不需要登录态；若前端调用时带过期 access， + * 网关不应在此处拦截 1002023000，否则 /refresh-token 永远走不到 system 的 1002023001 / 业务逻辑。 + */ + private static final Set SKIP_AUTH_PATHS = Set.of( + "/admin-api/system/auth/login", + "/admin-api/system/auth/logout", + "/admin-api/system/auth/refresh-token", + "/admin-api/system/auth/register" + ); + private final WebClient webClient; private final LoadingCache loginUserCache = buildAsyncReloadingCache(Duration.ofMinutes(1), @@ -58,6 +71,11 @@ public class TokenAuthenticationFilter implements GlobalFilter, Ordered { public Mono filter(ServerWebExchange exchange, GatewayFilterChain chain) { exchange = SecurityFrameworkUtils.removeLoginUser(exchange); + // 白名单路径直接放行，不做 token 校验 + if (SKIP_AUTH_PATHS.contains(exchange.getRequest().getPath().value())) { + return chain.filter(exchange); + } + String token = SecurityFrameworkUtils.obtainAuthorization(exchange); if (StrUtil.isEmpty(token)) { return chain.filter(exchange); diff --git a/rdms-system/2026-05-11-file-upload-api-改造需求.md b/rdms-system/2026-05-11-file-upload-api-改造需求.md deleted file mode 100644 index c61ed8a..0000000 --- a/rdms-system/2026-05-11-file-upload-api-改造需求.md +++ /dev/null @@ -1,98 +0,0 @@ -# 文件上传接口改造需求（给后端） - -> 提单时间：2026-05-11 -> 提单方：前端 -> 涉及模块：`rdms-system-boot` 文件模块 -> 背景：业务表单（如新建/编辑任务）的附件采用「即传即存」交互，但表单可能被用户取消或关闭。前端需要在合适时机调用删除接口清理孤儿文件。当前 `/system/file/upload` 只返回 url，前端拿不到 fileId，无法触发删除。 - ---- - -## 1. 改造：`POST /system/file/upload` - -**路径 / 方法 / 入参全部保持不变**，仅修改返回结构。 - -### 1.1 现状返回 - -```json -{ - "code": 0, - "msg": "", - "data": "http://192.168.1.107:9009/rdms/20260508/xxx.jpg?X-Amz-..." -} -``` - -### 1.2 目标返回 - -```json -{ - "code": 0, - "msg": "", - "data": { - "id": "10001", - "url": "http://192.168.1.107:9009/rdms/20260508/xxx.jpg?X-Amz-..." - } -} -``` - -### 1.3 字段说明 - -| 字段 | 类型 | 必填 | 说明 | -|---|---|---|---| -| id | string | 是 | 即 `infra_file.id`，**必须以字符串形式返回**，不要返回 number | -| url | string | 是 | 文件访问 URL，含义与现状完全一致（私有桶带签名，公开桶裸 URL） | - -### 1.4 关键约束 - -- **`id` 必须是 string，不是 number**。原因：`infra_file.id` 是 Long 类型，超过 JS 安全整数（2^53）时 JSON number 会精度丢失。前端项目 ID 统一按字符串接收。 -- 该改动**不兼容老返回结构**，前端会同步切换。 -- App 端 `/app-api/system/file/upload` 前端目前未使用，可暂不改；若希望对称建议一起改。 - ---- - -## 2. 确认：`DELETE /system/file/delete` - -接口已存在（见 `system-file-api.md` §4.3.5），无需新建，但需确认以下两点： - -### 2.1 权限 - -- 业务用户角色需具备 `system:file:delete` 权限码，**或**该接口允许"删除自己上传的文件"无需该权限码。 -- 期望：当前业务用户能直接调通 `DELETE /admin-api/system/file/delete?id=xxx`。 - -### 2.2 幂等性（删不存在的文件） - -- 当前文档里删不存在的文件返回错误码 `1001003001 / 文件不存在`。 -- 期望：**幂等返回 `code: 0`**（更佳），或维持现状（前端会把该错误码当作"已删除"吞掉，也能接受）。 - -### 2.3 入参 - -保持现状不变： - -``` -DELETE /admin-api/system/file/delete?id=10001 -``` - ---- - -## 3. 不在本次范围（避免误解） - -以下事项**本次不做**，属于后续「治本方案」范畴，请勿顺手改动： - -- 不需要在 `infra_file` 表加 `status`（temp / committed）字段 -- 不需要加业务引用关系表 -- 不需要做孤儿文件定时清理 cron -- 不需要改 `/presigned-url` 与 `/create` -- 不需要改 App 端 `/upload` 鉴权策略 - ---- - -## 4. 联调要点 - -1. 改造完成后请提供测试环境，前端会同步发版。 -2. 接口返回的 `id` 请确保转为字符串再 JSON 序列化（不要直接序列化 Long）。 -3. 若返回里 `id` 是 number 类型，前端视为联调未通过。 - ---- - -## 5. 一句话总结 - -> `/system/file/upload` 返回结构从 `string` 改成 `{ id: string, url: string }`，`id` 是 `infra_file.id` 的字符串形式。其它接口不动。