diff --git a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java index bec31078f..3178c7c66 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java +++ b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java @@ -6,6 +6,7 @@ import com.nanri.aiimage.common.exception.BusinessException; import com.nanri.aiimage.common.model.entity.AdminUserEntity; import com.nanri.aiimage.common.security.AdminAuthSupport; import com.nanri.aiimage.common.security.DeviceSessionPolicy; +import jakarta.annotation.PostConstruct; import jakarta.servlet.FilterChain; import jakarta.servlet.ServletException; import jakarta.servlet.http.HttpServletRequest; @@ -149,8 +150,42 @@ public class AdminApiGuardFilter extends OncePerRequestFilter { private String exemptPrefixes; /** 用户态接口的数据归属参数:收紧前它由客户端随意填。 */ + /** 巡检/发布记录用的 ASCII 锚点:三档开关的启动自述都带它(同 [client-version-floor] 口径)。 */ + static final String SWITCH_ANCHOR = "[api-guard-switch]"; private static final String USER_ID_PARAM = "user_id"; + /** + * 启动自述:把「三档开关各在什么位置」打成一条 grep 得动的日志(ASCII 锚点 {@value #SWITCH_ANCHOR})。 + * + *
动机与 {@code ClientVersionGuardFilter.reportFloorState()} 同一件:这四键过去只在代码里,
+ * 「名单写了一堆但一条都不强制」在日志上和「这个过滤器不存在」完全同形。
+ * 锚点用 ASCII 是现网口径——中文签名在容器日志换了编码后整条 grep 失效。
+ */
+ @PostConstruct
+ void reportGuardState() {
+ if (!enabled) {
+ log.warn("{} admin-guard-enabled=false ⇒ 本过滤器逐请求整体跳过(紧急回退态):"
+ + "{} 条用户态前缀与 /api/admin、/debug 以及无条件名单 {} 条都没有兜底鉴权,"
+ + "只剩 controller 里的 require*",
+ SWITCH_ANCHOR, USER_TOOL_PREFIXES.length, SELF_SERVICE_PREFIXES.length);
+ return;
+ }
+ if (!userToolGuardEnabled) {
+ log.warn("{} aiimage.security.user-tool-guard-enabled=false ⇒ 名单里 {} 条用户态前缀"
+ + "不强制凭据(带 user_id 的匿名请求按参数定归属,只剩「身份能解析出来时参数必须对齐」那一半);"
+ + "仍无条件强制的是 /api/admin、/debug 与 {} 条自助前缀",
+ SWITCH_ANCHOR, USER_TOOL_PREFIXES.length, SELF_SERVICE_PREFIXES.length);
+ return;
+ }
+ Set