升级jOOQ 3.17.1后生成代码不兼容JDK 11问题咨询

• jOOQ 3.17.x 版本的jooq-codegen代码生成组件本身不支持使用JDK 11运行：该模块从3.17版本开始将编译目标版本升级为JDK 17，对应class文件版本号为61.0，必须用JDK 17及以上版本启动代码生成流程，不存在低版本JDK下的兼容运行方案。
• 代码生成器输出的源码可以通过配置适配JDK 11，编译阶段出现的文本块语法报错，是因为默认配置下生成器会匹配自身运行的JDK版本输出对应语法的代码，未做低版本兼容处理。

1. 拆分构建期JDK与业务代码JDK版本 #

代码生成是构建阶段的独立任务，不需要和项目主业务代码的编译、运行JDK版本绑定：

• Maven构建场景：配置jooq-codegen-maven插件通过Maven Toolchain指定JDK 17+运行代码生成任务，主工程依然保持JDK 11的编译、打包配置即可
• Gradle构建场景：给jOOQ代码生成对应的task单独指定JDK 17+的Java启动路径即可

2. 配置生成器输出JDK 11兼容代码 #

在jOOQ代码生成配置（可以是独立的jooq-config.xml，也可以是Maven/Gradle插件内的configuration节点）的generator.target节点下，添加目标Java版本配置，示例配置片段：

<generator>
  <target>
    <!-- 原有配置：包名、源码输出路径等 -->
    <packageName>com.myapp.portal.backend.jooq</packageName>
    <directory>/home/runner/work/waste-coordinator/waste-coordinator/webapp/target/generated-sources/jooq</directory>
    <!-- 新增JDK 11兼容配置 -->
    <java>11</java>
  </target>
</generator>

配置完成后重新执行代码生成，输出的源码将自动规避JDK 11不支持的语法特性，不会再出现文本块相关的编译错误。

• 无需将整个项目的编译、运行JDK升级到17，仅代码生成的构建环节需要JDK 17+环境
• 不要尝试通过修改编译参数、手动修改生成源码的方式绕过版本限制，后续每次重新生成代码都会复现问题，维护成本极高

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