refactor(api): 统一 HTTP 200 响应契约

This commit is contained in:
2026-08-01 10:17:20 +08:00
parent f2e8935dbc
commit cad6c37af4
45 changed files with 689 additions and 289 deletions
@@ -0,0 +1,31 @@
package com.baiyue.common.web;
import org.junit.jupiter.api.Test;
import org.springframework.boot.autoconfigure.AutoConfigurations;
import org.springframework.boot.test.context.runner.ApplicationContextRunner;
import static org.assertj.core.api.Assertions.assertThat;
class CommonWebAutoConfigurationTest {
private final ApplicationContextRunner contextRunner = new ApplicationContextRunner()
.withConfiguration(AutoConfigurations.of(CommonWebAutoConfiguration.class));
@Test
void registersExceptionHandlerAndCorrelationFilterOutsideComponentScan() {
contextRunner.run(context -> {
assertThat(context).hasSingleBean(GlobalExceptionHandler.class);
assertThat(context).hasSingleBean(CorrelationIdFilter.class);
});
}
@Test
void backsOffWhenApplicationProvidesItsOwnBeans() {
contextRunner.withBean(GlobalExceptionHandler.class, GlobalExceptionHandler::new)
.withBean(CorrelationIdFilter.class, CorrelationIdFilter::new)
.run(context -> {
assertThat(context).hasSingleBean(GlobalExceptionHandler.class);
assertThat(context).hasSingleBean(CorrelationIdFilter.class);
});
}
}
@@ -2,11 +2,13 @@ package com.baiyue.common.web;
import com.baiyue.common.core.api.ResultCode;
import com.baiyue.common.core.exception.BizException;
import io.micrometer.core.instrument.simple.SimpleMeterRegistry;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.mock.web.MockHttpServletRequest;
import org.springframework.core.MethodParameter;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import org.springframework.test.util.ReflectionTestUtils;
import java.lang.reflect.Method;
@@ -22,7 +24,7 @@ class GlobalExceptionHandlerTest {
request.setAttribute(CorrelationContext.REQUEST_ID, "r1");
request.setAttribute(CorrelationContext.TRACE_ID, "t1");
var response = handler.handleBusiness(new BizException("inventory is locked"), request);
assertThat(response.getStatusCode().value()).isEqualTo(400);
assertThat(response.getStatusCode().value()).isEqualTo(200);
assertThat(response.getBody().code()).isEqualTo(ResultCode.BUSINESS_ERROR.code());
assertThat(response.getBody().requestId()).isEqualTo("r1");
}
@@ -37,10 +39,22 @@ class GlobalExceptionHandlerTest {
var response = handler.handleBadRequest(exception, request);
assertThat(response.getStatusCode().value()).isEqualTo(400);
assertThat(response.getStatusCode().value()).isEqualTo(200);
assertThat(response.getBody().code()).isEqualTo(ResultCode.BAD_REQUEST.code());
}
@Test
void recordsBusinessFailureMetricByFiniteResultCode() {
SimpleMeterRegistry registry = new SimpleMeterRegistry();
ReflectionTestUtils.setField(handler, "meterRegistry", registry);
handler.handleBusiness(new BizException(ResultCode.CONFLICT, "duplicate"),
new MockHttpServletRequest());
assertThat(registry.get("baiyue.api.business.failures")
.tag("code", ResultCode.CONFLICT.code()).counter().count()).isEqualTo(1.0);
}
private void paging(long page) {
}
}