jOOQ从关联端查询一对一关联对象时GuildMembersRecord为空

问题根源 #

你当前的查询逻辑存在两个关键问题：

• 子查询未与外层USERS表做关联，而是硬编码使用了固定的key值，虽然逻辑上key等于USERS.ID，但jOOQ会将其视为常量，若子查询返回多行结果，会导致row()处理失败返回空值。
• 嵌套子查询的写法不符合jOOQ对嵌套记录的解析规则，无法正确映射到GuildMembersRecord对象。

修复方案 #

方案一：使用JOIN查询（推荐，性能更优）

既然GuildMembers是关联关系的拥有端，直接用LEFT JOIN（兼容用户无关联 guild 记录的场景）关联两张表，再映射结果：

UUID key = UUID.randomUUID();
this.context.select(
        USERS.ID,
        USERS.USERNAME,
        USERS.IP_ADDRESS,
        USERS.LAST_JOIN_AT,
        USERS.CREATED_AT,
        USERS.UPDATED_AT,
        GUILD_MEMBERS.ID,
        GUILD_MEMBERS.GUILD_ID,
        GUILD_MEMBERS.USER_ID,
        GUILD_MEMBERS.ROLE,
        GUILD_MEMBERS.UPDATED_AT,
        GUILD_MEMBERS.CREATED_AT
    )
    .from(USERS)
    .leftJoin(GUILD_MEMBERS)
    .on(GUILD_MEMBERS.USER_ID.eq(USERS.ID))
    .where(USERS.ID.eq(key))
    .fetchOne(r -> new User(
        r.get(USERS.ID),
        r.get(USERS.USERNAME),
        r.get(USERS.IP_ADDRESS),
        r.get(USERS.LAST_JOIN_AT),
        r.get(USERS.CREATED_AT),
        r.get(USERS.UPDATED_AT),
        r.get(GUILD_MEMBERS.ID) == null ? null : r.into(GUILD_MEMBERS).into(GuildMembersRecord.class)
    ));

方案二：修复嵌套子查询逻辑

如果坚持使用子查询，需要让子查询关联外层USERS表，并确保返回单行结果：

UUID key = UUID.randomUUID();
this.context.select(
        USERS.ID,
        USERS.USERNAME,
        USERS.IP_ADDRESS,
        USERS.LAST_JOIN_AT,
        USERS.CREATED_AT,
        USERS.UPDATED_AT,
        DSL.field(
            DSL.select(row(GUILD_MEMBERS.fields()))
                .from(GUILD_MEMBERS)
                .where(GUILD_MEMBERS.USER_ID.eq(USERS.ID))
                .limit(1) // 强制返回单行，避免多行结果导致异常
        ).convertFrom(r -> r == null ? null : r.into(GUILD_MEMBERS).into(GuildMembersRecord.class))
    )
    .from(USERS)
    .where(USERS.ID.eq(key))
    .fetchOne(Records.mapping(User::new));

补充说明 #

• 如果用户与GuildMembers是一对一关系，两种方案都适用；如果是一对多，建议改用fetchGroups或其他集合映射方式。
• 注意GuildMembersRecord的代码里OffsetDateTime updatedAt后少了一个逗号，需先修复这个语法错误，否则映射时会报错。

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