使用jOOQ 3.11.9连接MySQL 8.0.11报错mysql.proc不存在的解决方案

这个问题我之前帮同事排查过，本质是jOOQ 3.11.9的元数据查询逻辑没跟上MySQL 8.0的结构变更：MySQL 8.0移除了旧版本里的mysql.proc表，把存储过程/函数的元数据全部迁移到information_schema.ROUTINES表了，但jOOQ 3.11.9还在硬编码查询mysql.proc来检测存储过程，所以才会触发这个错误。

下面是几个可行的解决办法，按推荐优先级排序：

1. 升级jOOQ到支持MySQL 8.0的版本（最优方案） #

jOOQ从3.12.x版本开始全面适配MySQL 8.0，已经修复了元数据查询依赖旧表的问题。如果项目允许升级，这是最彻底的解决方案：

• 升级后不仅能解决当前错误，还能获得MySQL 8.0新特性的更好支持（比如窗口函数、JSON操作的兼容优化）
• 小提醒：升级前要扫一遍jOOQ的API变更文档，部分旧版本的API在3.12+可能被标记为过时，需要做小幅代码调整

2. 禁用jOOQ对存储过程的元数据检测（应急方案） #

如果暂时没法升级jOOQ，可以通过配置关闭存储过程的元数据加载，让jOOQ跳过对mysql.proc的查询：

代码中配置Settings #

// 创建禁用存储过程元数据加载的Settings实例
Settings settings = new Settings()
    .withMetaIncludeProcedures(false);

// 用该Settings初始化DSLContext
DSLContext dslContext = DSL.using(
    yourMySQLConnection, 
    SQLDialect.MYSQL_8_0, 
    settings
);

代码生成器配置（如果用jOOQ生成实体类） #

在代码生成的XML配置里，添加排除存储过程的设置：

<generator>
  <database>
    <!-- 禁止生成存储过程相关的代码 -->
    <includeProcedures>false</includeProcedures>
    <!-- 额外排除可能触发查询的系统表 -->
    <excludes>mysql\.proc</excludes>
  </database>
</generator>

3. 手动创建兼容视图（不推荐，仅极端场景使用） #

如果以上两种方案都无法实施，可以在MySQL里手动创建mysql.proc视图，模拟旧表结构来骗过jOOQ：

CREATE VIEW mysql.proc AS
SELECT 
  ROUTINE_NAME AS name,
  ROUTINE_SCHEMA AS db,
  'PROCEDURE' AS type,
  SPECIFIC_NAME AS specific_name,
  LANGUAGE,
  SQL_DATA_ACCESS,
  IS_DETERMINISTIC,
  SECURITY_TYPE,
  DEFINER,
  CREATED,
  LAST_ALTERED AS modified,
  SQL_MODE,
  ROUTINE_COMMENT AS comment,
  CHARACTER_SET_CLIENT,
  COLLATION_CONNECTION,
  DATABASE_COLLATION AS db_collation,
  ROUTINE_BODY AS body
FROM information_schema.ROUTINES
WHERE ROUTINE_TYPE = 'PROCEDURE';

注意：这个方案是临时妥协，视图的结构没法完全匹配旧mysql.proc的所有字段，后续可能引发其他元数据查询错误，仅在极端情况下尝试。

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