Springboot3+的id字符串转化问题

以下是纯后端实现 Long/BigInteger ID 转为 JSON 字符串 的详细配置方案，基于 Spring Boot 3+ 和 SpringDoc (OpenAPI) 最新实践 ✨

1. 添加依赖

确保你的 pom.xml（或 Gradle）中包含：

<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId>
</dependency>
<dependency><groupId>com.fasterxml.jackson.datatype</groupId><artifactId>jackson-datatype-jsr310</artifactId>
</dependency>
<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.x</version>
</dependency>

2. 全局 Jackson 配置

创建一个全局 ObjectMapper，让所有 Long 类型自动序列化为字符串：

@Configuration
public class JacksonConfig {@Bean@Primarypublic ObjectMapper objectMapper() {ObjectMapper mapper = new ObjectMapper();// Java 8 日期时间支持mapper.registerModule(new JavaTimeModule());mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);// 去掉 null 字段mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);// 将 Long / long 转为 StringSimpleModule idModule = new SimpleModule();idModule.addSerializer(Long.class, ToStringSerializer.instance);idModule.addSerializer(Long.TYPE, ToStringSerializer.instance);idModule.addSerializer(BigInteger.class, ToStringSerializer.instance);mapper.registerModule(idModule);return mapper;}
}

上述配置无需在 POJO 上添加注解，确保所有后端输出中的 Long/BigInteger 都以字符串形式传输。这是社区常用解决方案，也是 StackOverflow 推荐做法 (github.com, stackoverflow.com)。

3. 精准控制（可选）

如有需求，仅针对某些字段转换，新增注解支持：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
@JacksonAnnotationsInside
@JsonSerialize(using = ToStringSerializer.class)
public @interface StringId {}

使用方式：

public class User {@StringIdprivate Long id;private String name;
}

并在全局配置中扫描该注解，使用 BeanSerializerModifier 判断并替换：

@Bean
public Jackson2ObjectMapperBuilderCustomizer customIdSerializer() {return builder -> builder.modules(new SimpleModule() {@Overridepublic void setupModule(SetupContext context) {context.addBeanSerializerModifier(new BeanSerializerModifier() {@Overridepublic List<BeanPropertyWriter> changeProperties(SerializationConfig config,BeanDescription beanDesc,List<BeanPropertyWriter> props) {return props.stream().map(writer -> {if (writer.getAnnotation(StringId.class) != null) {return writer.withSerializer(ToStringSerializer.instance);}return writer;}).toList();}});}});
}

4. OpenAPI (SpringDoc) 类型同步

为了 Swagger 文档中显示 ID 为 “string” 而不是 “integer”，增加 OpenAPI 自定义：

@Bean
public OpenApiCustomiser idAsStringSchemaCustomizer() {return openApi -> {openApi.getComponents().getSchemas().forEach((name, schema) -> {if (schema.getProperties() != null) {schema.getProperties().forEach((propName, propSchema) -> {if (propName.toLowerCase().endsWith("id") && "integer".equals(propSchema.getType())) {propSchema.setType("string");propSchema.setFormat("int64");}});}});};
}

📌 使用步骤总结

引入依赖 - Jackson、JSR‑310、SpringDoc。
配置全局 ObjectMapper - Long/String 自动转换。
（可选）添加 @StringId 注解 - 精细控制。
同步 OpenAPI Schema 类型 - Swagger 查看准确。
测试验证：序列化、反序列化均正常。

✅ 测试示例

@SpringBootTest
public class IdConversionTest {@Autowired ObjectMapper mapper;@Testvoid testLongToString() throws Exception {TestEntity e = new TestEntity();e.setId(1234567890123456789L);String json = mapper.writeValueAsString(e);assertTrue(json.contains("\"id\":\"1234567890123456789\""));}@Testvoid testStringToLong() throws Exception {String json = "{\"id\":\"1234567890123456789\"}";TestEntity e = mapper.readValue(json, TestEntity.class);assertEquals(1234567890123456789L, e.getId());}static class TestEntity { Long id; /* getter-setter */ }
}