本文介绍在 jOOQ 中通过添加符合 JavaBean 规范的 getter 方法，将 POJO 字段（如 myTitle）正确映射到同义但命名不同的数据库列（如 title），从而解决 newRecord(table, pojo) 插入时字段丢失的问题。
本文介绍在 jooq 中通过添加符合 javabean 规范的 getter 方法，将 pojo 字段（如 `mytitle`）正确映射到同义但命名不同的数据库列（如 `title`），从而解决 `newrecord(table, pojo)` 插入时字段丢失的问题。
jOOQ 在将 POJO 映射为 Record 时（例如调用 create.newRecord(BOOK, myBook)），默认依赖 JavaBean 标准命名约定：即仅识别形如 getXxx() / isXxx() 的 getter 方法，并将其与表中同名（忽略大小写及 get/is 前缀）的字段自动关联。它不会基于字段名（如 myTitle）直接映射到列 title，也不会响应 @Column(name = "title") 注解（该注解仅在 Result.into(MyBook.class) 反向映射查询结果时生效）。
因此，要使 myTitle 字段参与插入，需在 MyBook 类中显式提供符合规范的 getter：
public class MyBook {
public int id;
public String myTitle;
// ✅ 关键：提供标准 getter，jOOQ 将其映射到列 "title"
public String getTitle() {
return myTitle;
}
// ✅ 可选：若需支持 setter（如后续更新），也建议提供
public void setTitle(String title) {
this.myTitle = title;
}
}
随后即可正常执行插入：
MyBook myBook = new MyBook(); myBook.id = 10; myBook.myTitle = "Animal Farm"; // jOOQ 会识别 getTitle() → 映射到 BOOK.TITLE 列 BookRecord record = create.newRecord(BOOK, myBook); record.store(); // INSERT INTO book (id, title) VALUES (10, 'Animal Farm')
⚠️ 注意事项：
- 字段本身（myTitle）无需 @Column 或其他注解；jOOQ 不扫描字段级注解用于写入映射。
- 若使用接口定义契约（如 BookDTO），可将 getTitle() 声明为接口方法，实现类中返回 myTitle，既保持封装又满足 jOOQ 要求。
- 此方案兼容所有 jOOQ 版本（3.14+ 及更早），无需额外配置或代码生成器干预。
- 避免仅依赖字段反射（如 Field.field("myTitle")），因 newRecord(table, pojo) 机制不支持字段名重映射。
总结：jOOQ 的 POJO→Record 映射本质是基于 getter 名称推导列名，而非字段名。通过添加语义一致的 getter（如 getTitle() 对应 title 列），即可优雅、零配置地完成字段到列的自定义映射，确保插入与更新操作数据完整。
