Spring Bean中Jackson CsvMapper无法注册JavaTimeModule问题求助

问题现象 #

将CsvMapper定义为Spring Bean时，手动添加的JavaTimeModule、KotlinModule等模块会被忽略，序列化/反序列化Java 8时间类时抛出错误：

Java 8 date/time type 'java.time.*' not supported by default

但在类的静态伴生对象中创建的CsvMapper实例，却能正常加载这些模块并处理时间类型。

失效的Bean代码 #

@Bean
fun csvMapper():CsvMapper = CsvMapper.builder()
        .enable(CsvParser.Feature.TRIM_SPACES)
        .enable(CsvParser.Feature.SKIP_EMPTY_LINES)
        .addModule(JavaTimeModule()).build()

正常工作的伴生对象代码 #

companion object {
    val csvMapper: CsvMapper = CsvMapper.builder()
        .enable(CsvParser.Feature.TRIM_SPACES)
        .enable(CsvParser.Feature.SKIP_EMPTY_LINES)
        .addModule(JavaTimeModule()).build()
}

原因分析 #

Spring Boot默认通过Jackson2ObjectMapperBuilder自动配置Jackson相关组件，当手动创建CsvMapper Bean时，Spring的自动配置逻辑可能会介入，覆盖或清除你手动添加的模块。此外，CsvMapper作为ObjectMapper的子类，自动配置的默认规则会对其生效，导致自定义模块未被正确保留。

解决方案 #

方案1：通过Jackson2ObjectMapperBuilder构建CsvMapper（推荐） #

利用Spring提供的Jackson2ObjectMapperBuilder来创建CsvMapper，确保模块被正确注册且不会被自动配置覆盖：

@Bean
fun csvMapper(builder: Jackson2ObjectMapperBuilder): CsvMapper {
    return builder.createXmlMapper(false)
        .build<CsvMapper>()
        .apply {
            enable(CsvParser.Feature.TRIM_SPACES)
            enable(CsvParser.Feature.SKIP_EMPTY_LINES)
            registerModule(JavaTimeModule())
            registerModule(KotlinModule.Builder().build())
        }
}

方案2：设置自定义Bean为Primary #

通过@Primary注解让Spring优先使用你自定义的CsvMapper实例，避免自动配置的Bean覆盖：

@Primary
@Bean
fun csvMapper():CsvMapper = CsvMapper.builder()
        .enable(CsvParser.Feature.TRIM_SPACES)
        .enable(CsvParser.Feature.SKIP_EMPTY_LINES)
        .addModule(JavaTimeModule())
        .addModule(KotlinModule.Builder().build())
        .build()

方案3：禁用Jackson自动配置（谨慎使用） #

在启动类上排除Jackson自动配置，完全自定义CsvMapper：

@SpringBootApplication(exclude = [JacksonAutoConfiguration::class])
class YourApplication

fun main(args: Array<String>) {
    runApplication<YourApplication>(*args)
}

此方式会影响项目中所有Jackson组件的自动配置，需自行处理所有相关Bean的定义。

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