本文介绍如何通过 Jackson 的 ObjectMapper 为指定 Java 类型（如 FooBar）全局启用 toString() 方法作为 JSON 序列化逻辑，无需修改类源码或添加 @JsonValue 注解，仅通过模块化配置即可实现。
本文介绍如何通过 jackson 的 `objectmapper` 为指定 java 类型（如 `foobar`）全局启用 `tostring()` 方法作为 json 序列化逻辑，无需修改类源码或添加 `@jsonvalue` 注解，仅通过模块化配置即可实现。
Jackson 默认不会调用对象的 toString() 方法进行序列化，但提供了高度可扩展的序列化机制。对于希望统一将某类实例序列化为其字符串表示（例如调试友好格式、枚举别名、ID 封装类等场景），推荐使用 ToStringSerializer —— 这是 Jackson 官方提供的标准序列化器，专为此类需求设计。
配置步骤（推荐方式）
使用 SimpleModule 注册自定义序列化器，适用于 Jackson 2.12+（包括 Java 17 环境）：
ObjectMapper mapper = JsonMapper.builder()
.build();
SimpleModule module = new SimpleModule();
module.addSerializer(FooBar.class, ToStringSerializer.instance()); // 推荐：复用单例实例
mapper.registerModule(module);✅ 注意：
ToStringSerializer.instance()是线程安全的单例，优于new ToStringSerializer()，避免不必要的对象创建。
效果示例
假设有如下 FooBar 类：
public class FooBar {
private final String id;
private final int version;
public FooBar(String id, int version) {
this.id = id;
this.version = version;
}
@Override
public String toString() {
return String.format("FB[%s#%d]", id, version);
}
}经上述配置后，执行：
String json = mapper.writeValueAsString(new FooBar("abc", 42));
System.out.println(json); // 输出: "FB[abc#42]"输出为带引号的 JSON 字符串（符合 JSON 规范），而非对象结构。
注意事项与最佳实践
不干扰其他类型：该配置仅影响
FooBar类及其直接实例（不作用于子类，除非显式注册）；优先级高于注解：若
FooBar同时标注了@JsonValue，则@JsonValue仍生效；addSerializer配置仅在无更高级别注解时起作用；反序列化不受影响：此配置仅控制序列化（Java → JSON）；反序列化（JSON → Java）需另行配置
Deserializer（如需支持，可结合FromStringDeserializer）；泛型与继承处理：如需对
FooBar子类也生效，可注册为Class extends FooBar>或使用SimpleModule.setSerializerModifier(...)进行动态判断；-
Spring Boot 用户提示：若使用 Spring Boot，默认
ObjectMapper可通过@Bean自定义模块：@Bean public Module fooBarToStringModule() { SimpleModule module = new SimpleModule(); module.addSerializer(FooBar.class, ToStringSerializer.instance()); return module; }
通过模块化注册 ToStringSerializer，你可在不侵入业务类的前提下，灵活、可维护地统一控制特定类型的 JSON 表现形式——这是 Jackson 面向扩展性与松耦合设计的最佳实践之一。
