Jooq查询Record类型时列索引读取异常问题求助

这个问题既不是PostgreSQL的问题，也不是JDBC驱动的问题，而是jOOQ代码生成与数据库表结构不一致导致的，具体分析如下：

核心原因 #

你用select(Tables.PORTAL_USER)生成的查询本质是SELECT *，PostgreSQL返回的列顺序严格遵循表的物理定义顺序（固定不变，除非表结构被修改），而jOOQ的PortalUserRecord期望的列顺序是代码生成阶段读取到的表列顺序。如果在代码生成后，数据库表的列顺序被调整过（比如执行ALTER TABLE修改列位置、新增/删除列），但没有重新生成jOOQ代码，就会出现两者列顺序不匹配的情况：jOOQ试图用Long类型去解析实际是日期类型的列值，自然抛出NumberFormatException。

“有时正常有时异常”的现象，大概率是因为测试环境/生产环境的表结构不一致，或者代码生成后表结构有过变更但未同步更新代码。

各组件角色澄清 #

• PostgreSQL：SELECT *返回的列顺序严格遵循表的物理定义，不会随机变化。
• JDBC驱动：完全按照数据库返回的列顺序传递结果，不会篡改列顺序。
• jOOQ 3.17.4：本身没有乱序问题，但代码生成的元数据必须和数据库表结构保持一致，否则会出现类型映射错误。

解决方案 #

1. 重新生成jOOQ代码：确保代码中的PortalUser字段顺序与当前数据库表的物理列顺序完全匹配。
2. **避免使用隐式SELECT ***：改为显式指定查询字段，比如：

   Result<PortalUserRecord> userList = dsl.select(
       PORTAL_USER.ID,
       PORTAL_USER.USER_NAME,
       PORTAL_USER.CREATE_TIME
       // 列出所有需要的字段
   ).from(Tables.PORTAL_USER).fetch();
   

   这种方式完全由代码控制列顺序，不受数据库表结构变化影响，同时也更符合SQL最佳实践。
3. 规范表结构变更流程：后续修改表结构（如调整列位置）后，必须同步重新生成jOOQ代码，避免元数据不一致。

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