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,正反两钉: + *