使用JOOQ fetchInto映射自定义POJO时，混合@Column注解导致未注解字段映射失效的问题排查

你遇到的这个问题其实是jOOQ的DefaultRecordMapper在处理JPA注解时的默认行为导致的：当你的POJO中存在任何@Column注解时，jOOQ会切换到「仅显式映射」模式，只处理带有@Column注解的字段，自动忽略那些没有注解但名字匹配的字段。

这是因为jOOQ默认认为，一旦你开始用JPA注解显式指定字段映射，就意味着你想要完全控制所有字段的映射规则，不再依赖它的自动驼峰-下划线命名匹配逻辑。这就是为什么你只给部分字段加注解时，未注解的字段哪怕名字完全匹配也会被设为null；而移除所有注解后，自动映射又能正常工作（此时jOOQ启用默认的命名约定匹配）。

针对这个问题，有两种常见的解决方式，你可以根据自己的需求选择：

方案1：给所有需要映射的字段添加@Column注解 #

这是最直接的方式，虽然有点繁琐，但能确保jOOQ处理所有字段。哪怕是名字和数据库列完全匹配的字段，也显式加上@Column注解：

@Getter @Setter 
public class TestClassDto { 
    @Column(name = "field_AB_XYZ")
    private Long myfieldAB; 
    // 显式添加注解，让jOOQ识别这个字段的映射
    @Column(name = "hello_world") 
    private Long helloWorld; 
}

这样修改后，jOOQ会处理所有带有@Column注解的字段，不管名字是否匹配，都能正确映射。

方案2：自定义映射配置，同时支持注解和自动匹配 #

如果你不想给所有字段加注解，可以通过配置DefaultRecordMapperConfiguration，让jOOQ在识别@Column注解的同时，依然自动映射那些名字匹配的未注解字段。

具体做法是在fetchInto时，传入自定义的DefaultRecordMapper配置：

// 创建自定义映射配置
DefaultRecordMapperConfiguration config = new DefaultRecordMapperConfiguration()
    .withUseJpaAnnotations(true) // 启用JPA注解支持
    .withMapUnannotatedFields(true); // 允许映射未注解的字段

// 使用自定义配置进行映射
List<TestClassDto> result = dslContext.select() 
    .from(SOMETHING) 
    .where(SOMETHING.NAME.eq("Something")) 
    .fetchInto(new DefaultRecordMapper<>(TestClassDto.class, config));

这个配置会让jOOQ优先使用@Column注解的映射规则，同时对那些没有注解但名字和数据库列匹配的字段，依然使用默认的驼峰-下划线命名约定进行自动映射。

注意：这个配置需要jOOQ 3.16及以上版本支持，如果你的jOOQ版本较低，可能需要升级或者改用其他方式。

额外提示 #

如果你同时使用Lombok和jOOQ，确保你的POJO有正确的getter/setter（你已经用了@Getter @Setter，这没问题），或者可以考虑用构造函数映射，开启jOOQ的构造函数参数名匹配功能，这样可以避免依赖注解，但需要编译时保留参数名（比如Java编译时加-parameters选项）。

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