Kotlin Jackson CSV序列化：含大写属性时列顺序错误且非确定性问题

这个问题我之前踩过坑，核心原因是Jackson在处理Kotlin混合大小写属性时，默认的属性发现逻辑会受JVM反射特性（比如getter方法的命名映射）影响，导致属性顺序不稳定；再加上你禁用了SORT_PROPERTIES_ALPHABETICALLY，就出现了非确定性的列顺序。至于@JsonPropertyOrder没生效，大概率是自动生成Schema时，Jackson没正确识别到注解和属性的关联关系。

下面给你几个可行的解决方案：

方案一：显式指定CSV Schema的列顺序（最直接有效） #

放弃自动生成Schema的默认逻辑，手动按照数据类的属性声明顺序指定列名，彻底固定输出顺序：

val bootstrapSchema = csvMapper.schemaFor(MyClass::class.java)
    .withUseHeader(true)
    // 严格按照数据类属性声明顺序指定列名
    .withColumnOrder("zProp1", "Prop2", "Prop3")

这里的列名用数据类的原始属性名即可，Jackson会自动处理你不关注的小写转换。

方案二：配置Jackson Kotlin模块强制遵循声明顺序 #

如果你不想手动维护列顺序，可以通过配置Jackson Kotlin模块，让它严格按照类定义的属性顺序解析，同时让@JsonPropertyOrder生效：

首先确保依赖中包含Jackson Kotlin模块（一般Kotlin项目都会引入），然后修改csvMapper的配置：

val csvMapper = CsvMapper().apply {
    disable(MapperFeature.SORT_PROPERTIES_ALPHABETICALLY)
    // 注册Kotlin模块并配置属性访问规则
    registerModule(kotlinModule {
        configure(KotlinFeature.UsePropertyAccessSyntax, true)
    })
    // 确保注解能被正确识别
    enable(MapperFeature.USE_ANNOTATIONS)
}

然后给数据类加上@JsonPropertyOrder注解，这次就能生效了：

@JsonPropertyOrder("zProp1", "Prop2", "Prop3")
class MyClass(
    val zProp1: Int,
    val Prop2: Int,
    val Prop3: Int
)

方案三：调整属性命名（备选） #

如果项目对命名规范要求不严格，把所有属性改成小写开头（比如prop2、prop3），Jackson就能稳定识别属性的声明顺序，这也是你已经验证过的方法，适合快速解决问题的场景。

补充：为什么之前的@JsonPropertyOrder没生效？ #

Kotlin数据类对首字母大写的属性，生成的getter方法是getProp2()，Jackson默认会把它映射为prop2；而你给原始属性Prop2加的注解，和Jackson实际识别的属性名不匹配，导致注解失效。手动指定列顺序或配置Kotlin模块后，Jackson就能正确关联注解和属性了。

内容的提问来源于stack exchange，提问作者J-bob