Spring Boot WebSocket下Jackson对象转JSON无异常中断问题求解

问题根因 #

• 版本兼容性冲突：Spring Boot 2.5.6 默认适配 Jackson 2.12.x 版本，且对 Java 17 仅为实验性支持，手动升级到 Jackson 2.13.0 后，和当前 Spring Boot 版本的 Jackson 自动配置逻辑存在适配问题，同时 Java 17 的强封装限制会拦截 Jackson 序列化所需的反射调用。
• 异常被静默吞噬：Spring WebSocket 端点方法的默认异常处理器会将未捕获的异常仅输出到 DEBUG 级以下日志，未配置全局异常处理器的前提下不会抛出上层，因此看不到报错信息，只会观察到程序中断。
• 运行上下文差异：main 方法运行时使用应用程序类加载器，且 IDE 默认会添加允许非法反射访问的 JVM 参数，序列化时没有权限限制；而 WebSocket 运行在 Servlet 容器的上下文类加载器下，默认启用 Java 17 强封装规则，同时如果自定义对象在 WebSocket 上下文里包含不可序列化字段（如 Session、流对象等），也会触发序列化失败。

解决方案 #

1. 定位具体异常 #

直接在 WebSocket 端点的序列化逻辑外层捕获 Throwable 类型异常，打印完整堆栈，即可快速定位具体报错：

// 示例代码
try {
    System.out.println("Generating");
    String json = new ObjectMapper().writeValueAsString(customObject);
    System.out.println(json);
} catch (Throwable t) {
    t.printStackTrace();
}

2. 修复版本依赖 #

二选一即可：

• 方案一：将 Jackson 版本回退到 2.12.5，和 Spring Boot 2.5.6 默认依赖版本保持一致，避免版本不兼容。
• 方案二：升级 Spring Boot 到 2.6.x 及以上版本，该版本开始正式支持 Java 17，且默认适配 Jackson 2.13.x 版本。

3. 解决 Java 17 反射权限限制 #

在 JVM 启动参数中添加以下配置，允许 Jackson 访问 JDK 内部成员：

--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.base/java.util=ALL-UNNAMED
--add-opens java.base/java.time=ALL-UNNAMED

4. 优化 ObjectMapper 使用方式 #

不要手动实例化 ObjectMapper，优先注入 Spring 上下文自动配置的 ObjectMapper 实例，该实例已经完成了当前 Spring Boot 版本的所有适配配置，兼容性更强：

@Autowired
private ObjectMapper objectMapper;

内容的提问来源于stack exchange，提问作者Michael