From 903ea61df7ad08ce6f993be67312f8f4636d84b6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Thu, 8 Oct 2026 10:32:29 +0800 Subject: [PATCH] =?UTF-8?q?fix(=E9=89=B4=E6=9D=83=E8=87=AA=E6=A3=80):=20?= =?UTF-8?q?=E5=AE=A1=E8=AE=A1=E5=99=A8=E6=8C=89=E7=B1=BB=E5=9E=8B=E6=B3=A8?= =?UTF-8?q?=E5=85=A5=E6=92=9E=20actuator=20=E7=AC=AC=E4=BA=8C=E5=80=99?= =?UTF-8?q?=E9=80=89=EF=BC=8C=E6=94=B9=E6=98=BE=E5=BC=8F=E6=9E=84=E9=80=A0?= =?UTF-8?q?=E5=99=A8=E5=B8=A6=20@Qualifier?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 2026-10-08 把上一版 jar 推到主机B 后容器 CrashLoop 5 次:RequestMappingHandlerMapping 在容器里有两个候选(WebMvc 的 + actuator 的 ControllerEndpointHandlerMapping,后者是前者 子类),按类型注入直接 NoUniqueBeanDefinitionException,而 4044 例单测全绿——因为本仓库 没有一例真正装配过 Spring 容器。 补 ApiGuardCoverageAuditorWiringTest 正反两钉:同一个容器里复现那对 bean,正钉审计器装配 成功且拿到 MVC 那个(拿错会在"0 个端点"上假绿),反钉不带限定符的注入必须真失败 (不钉反例,第二支 bean 一旦不再继承,正例就退化成恒真)。摘掉 @Qualifier 变异实测变红。 --- .../config/ApiGuardCoverageAuditor.java | 14 ++- .../ApiGuardCoverageAuditorWiringTest.java | 100 ++++++++++++++++++ 2 files changed, 112 insertions(+), 2 deletions(-) create mode 100644 backend-java/src/test/java/com/nanri/aiimage/config/ApiGuardCoverageAuditorWiringTest.java diff --git a/backend-java/src/main/java/com/nanri/aiimage/config/ApiGuardCoverageAuditor.java b/backend-java/src/main/java/com/nanri/aiimage/config/ApiGuardCoverageAuditor.java index 74c0e7270..9de13d8b5 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/config/ApiGuardCoverageAuditor.java +++ b/backend-java/src/main/java/com/nanri/aiimage/config/ApiGuardCoverageAuditor.java @@ -1,7 +1,7 @@ package com.nanri.aiimage.config; -import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Qualifier; import org.springframework.boot.context.event.ApplicationReadyEvent; import org.springframework.context.event.EventListener; import org.springframework.stereotype.Component; @@ -37,7 +37,6 @@ import java.util.Set; */ @Slf4j @Component -@RequiredArgsConstructor public class ApiGuardCoverageAuditor { /** 巡检锚点:_prod_watch.py 按这个字面量 grep,改名要同时改那条签名。 */ @@ -76,6 +75,17 @@ public class ApiGuardCoverageAuditor { private final RequestMappingHandlerMapping handlerMapping; + /** + * 必须显式写构造器带 {@code @Qualifier}:actuator 另注册了一个 {@code ControllerEndpointHandlerMapping} + * (它是 {@code RequestMappingHandlerMapping} 的子类),按类型注入就有 2 个候选,容器直接起不来。 + * 字段上写 {@code @Qualifier} 也不行——Lombok 不会把它拷进生成的构造参数,而 {@code @RequiredArgsConstructor} + * 生成的正是那个构造器。2026-10-08 主机B 就是栽在这里(CrashLoop 5 次,单测 4044 例全绿)。 + */ + public ApiGuardCoverageAuditor( + @Qualifier("requestMappingHandlerMapping") RequestMappingHandlerMapping handlerMapping) { + this.handlerMapping = handlerMapping; + } + @EventListener(ApplicationReadyEvent.class) public void auditOnBoot() { Report report = audit(mappedPaths()); diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/ApiGuardCoverageAuditorWiringTest.java b/backend-java/src/test/java/com/nanri/aiimage/config/ApiGuardCoverageAuditorWiringTest.java new file mode 100644 index 000000000..0e42d39e3 --- /dev/null +++ b/backend-java/src/test/java/com/nanri/aiimage/config/ApiGuardCoverageAuditorWiringTest.java @@ -0,0 +1,100 @@ +package com.nanri.aiimage.config; + +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.BeanCreationException; +import org.springframework.context.annotation.AnnotationConfigApplicationContext; +import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping; + +import java.lang.reflect.Field; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * {@link ApiGuardCoverageAuditor} 的容器接线测试。 + * + *
本仓库 4044 例全是 Mockito 单测,没有一例真正装配过 Spring 容器,所以"构造函数造不造得出来" + * 这件事在测试里是空白的。2026-10-08 就是靠这个空白把一支起不来的 jar 推上了主机B: + * actuator 也注册了一个 {@code RequestMappingHandlerMapping} 的子类 + * ({@code ControllerEndpointHandlerMapping}),按类型注入命中 2 个候选 ⇒ + * {@code NoUniqueBeanDefinitionException} ⇒ 容器不启动,而单测全绿。 + * + *
这里在同一个容器里复现那对 bean,正反两钉: + *