当 Jackson 解析 JSON 时遇到类中未定义的字段（如 "status"），默认会抛出 UnrecognizedPropertyException；通过配置 ObjectMapper 全局禁用 FAIL_ON_UNKNOWN_PROPERTIES，可安全跳过所有未知字段，避免逐个类添加注解。
当 jackson 解析 json 时遇到类中未定义的字段（如 `"status"`），默认会抛出 `unrecognizedpropertyexception`；通过配置 `objectmapper` 全局禁用 `fail_on_unknown_properties`，可安全跳过所有未知字段，避免逐个类添加注解。
在 Spring Boot 应用中，上述错误表明 JSON 响应包含一个名为 "status" 的字段，但目标类 KYCScoreIndResponse 并未声明该属性，且 Jackson 默认严格校验字段匹配。虽然你尝试使用 @JsonProperty 显式映射或 @JsonIgnoreProperties 局部忽略，但若接口响应结构不稳定（如第三方服务动态增加字段），逐类处理既繁琐又易遗漏。
推荐方案：全局配置 ObjectMapper
在 Spring Boot 配置类中定义自定义 ObjectMapper Bean，关闭未知字段失败策略：
@Configuration
public class JacksonConfig {
@Bean
public ObjectMapper objectMapper() {
ObjectMapper mapper = new ObjectMapper();
// 关键配置：反序列化时忽略未知字段，不抛异常
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// （可选）提升健壮性：允许单引号、尾部逗号等非标准 JSON
mapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true);
mapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);
return mapper;
}
}
✅ 效果说明：
- 所有
@RequestBody、RestTemplate或WebClient反序列化均自动应用该配置； - 不再需要在每个 DTO 类上重复添加
@JsonIgnoreProperties(ignoreUnknown = true)； - 已存在的
@JsonIgnore、@JsonProperty等注解仍正常生效，与全局配置兼容。
⚠️ 注意事项：
- 此配置降低校验强度，建议仅在对接外部不可控 API 时启用；内部服务间调用推荐保持严格模式（
true），便于早期发现契约不一致； - 若需对特定类保留严格校验，可单独在其类上添加
@JsonIgnoreProperties(ignoreUnknown = false)（需配合@JsonInclude等注解显式启用）； - Spring Boot 2.6+ 中，若已存在
spring.jackson.deserialization.fail-on-unknown-properties=false配置项，亦可直接在application.yml中声明，无需 Java Bean：
spring:
jackson:
deserialization:
fail-on-unknown-properties: false
综上，全局禁用未知字段校验是高效、统一且符合 Spring Boot 惯例的解决方案，兼顾开发效率与系统稳定性。
