为什么JOOQ的fetchOneInto(Pojo.class)仅填充id字段其余字段为null

开发者阿泽

2026-10-3

问题根因

你遇到的映射失败问题是由两个常见配置缺失导致的：

jOOQ 默认未开启JPA注解识别能力，你在POJO字段上添加的@Column、类上的@Table注解默认不会生效
未开启注解时jOOQ会按照「数据库字段名转驼峰」的规则和POJO字段/Setter方法做匹配，你的POJO字段命名和转换后的规则不匹配：
- 数据库字段username转驼峰为username，POJO对应字段为userName，大小写不匹配
- 数据库字段phone转驼峰为phone，POJO对应字段为userPhone，命名不一致
- 仅id字段两边命名完全一致，所以能正常赋值

解决方案

你可以任选以下一种方案修复：

方案1：开启JPA注解支持

创建DSLContext时显式开启注解识别配置，即可让你写的@Column注解生效：

// 调整DSLContext初始化逻辑
Configuration config = new DefaultConfiguration()
        .set(yourConnection)
        .set(SQLDialect.MYSQL)
        // 开启JPA注解支持
        .set(new DefaultRecordMapperProvider(
                new RecordMapperConfiguration().withAnnotationsEnabled(true)
        ));
DSLContext dslContext = DSL.using(config);

如果你使用Spring Boot整合jOOQ，直接在application配置中添加以下配置即可：

spring.jooq.record-mapper-annotations-enabled=true

方案2：调整POJO命名匹配默认映射规则

不想改配置的话，直接把POJO字段和对应的Getter/Setter修改为和数据库字段转驼峰后的结果完全一致即可：

public class User {
    private Integer id;
    // 对应数据库字段username
    private String username;
    // 对应数据库字段phone
    private String phone;
    // 对应数据库字段email
    private String email;
    private String password;

    // 对应Getter/Setter也要同步修改，比如getUsername()、setUsername()
}