railwaysystem/docs/codebase-audit/16_kingbase_readonly_compatibility.md

Kingbase 只读兼容性核验

1. 核验边界与方法

本报告针对当前项目实际连接的 Kingbase 实例执行只读探测。连接复用现有数据源配置，通过项目已有 Kingbase JDBC 驱动建立；事务设置为只读，全部业务探测均使用 SELECT、SHOW 或系统目录查询，结束时执行回滚并关闭连接。未执行任何 DDL、DML、迁移或生成键写入测试，也未在报告中记录连接密码。

当前环境证据：

项目	实际结果
数据库产品	KingbaseES V009R003C018
JDBC 驱动	Kingbase8 JDBC Driver V008R006B0001；Maven 依赖版本 8.6.0
database	training
schema	public
database_mode	mysql
服务端兼容基线	server_version 返回 12.1
简单 SELECT	正常

2. 指定语法的实测结果

探测项	无副作用测试形式	实际结果	分类	对当前代码的含义
date_format	对固定 timestamp 格式化为 %Y%m%d	返回 20260102	兼容模式支持	若依 Mapper 中同类写法可被当前实例解析
ifnull	ifnull(null,'fallback')	返回 fallback	兼容模式支持	当前 Mapper 中的空值表达式可被解析
find_in_set	find_in_set('2','1,2,3')	返回 2	兼容模式支持	若依数据权限中同类表达式具备语法基础
current_database()	查询当前数据库	返回 training	当前实例直接支持	函数本身可用，但不能代替当前 schema，见第4节
sysdate()	查询当前时间	返回 timestamp	兼容模式支持	MySQL 风格当前时间函数可用
LIMIT 1 OFFSET 1	常规分页 SELECT	正常返回	当前实例直接支持	PostgreSQL/Kingbase 风格分页可用
LIMIT 0,1	MySQL 风格分页 SELECT	正常返回	兼容模式支持	当前 PageHelper helperDialect=mysql 具备语法基础
SELECT 1 FROM dual	数据源校验形式	返回 1	兼容模式支持	当前 Druid validation query 可用
反引号标识符	使用反引号访问 public.sys_menu 字段	正常返回	兼容模式支持	代码生成器中的反引号可被当前实例解析

本次明确列出的 MySQL 语法探测均通过。结论只适用于当前 database_mode=mysql 实例，不能据此推断其他 Kingbase 实例或其他兼容模式也会通过。

3. PageHelper 分页判断

配置依据：

• ruoyi-admin/src/main/resources/application.yml 中 PageHelper 使用 helperDialect: mysql。
• 当前实例能够执行 LIMIT offset,row_count，所以 PageHelper 常见的 MySQL 分页尾句在语法层面可用。

只读测试没有启动完整 Web 请求链，也没有核对每一种复杂 Mapper SQL 经 PageHelper 改写后的结果。当前可判定为“分页基础语法兼容”，完整插件行为仍需后续集成测试。

4. 已确认的应用级兼容冲突

4.1 代码生成器把 database 当作 schema

当前代码生成器在信息模式查询中使用：

table_schema = current_database()

当前 current_database() 是 training，实际业务表 schema 是 public。只读核验结果：

• 按当前生成器条件查询：0 张表；
• public schema 实际有 46 张表；
• public.train_teacher 实际有 12个字段，按当前生成器条件查询为0个字段。

因此这不是 SQL 函数不支持，而是 database 与 schema 语义被混用。当前代码生成模块无法依靠这组查询正确发现实际表结构，数据库 V2 前必须明确处理。

相关文件：

• ruoyi-generator/src/main/resources/mapper/generator/GenTableMapper.xml
• ruoyi-generator/src/main/resources/mapper/generator/GenTableColumnMapper.xml

4.2 sys_* 名称与 Kingbase 系统视图冲突

当前隐式 schema 搜索顺序为：

sys, pg_catalog, sys_catalog, public

sys_catalog 中存在 sys_user、sys_role、sys_config 系统视图，public 中同时存在若依同名业务表。当前若依 Mapper 普遍使用未限定 schema 的表名。只读探测显示：

• 未限定的 sys_user.user_id 查询失败，命中了系统视图；
• 未限定的 sys_role.role_id 查询失败，命中了系统视图；
• 未限定的 sys_config.config_id 查询失败，命中了系统视图；
• 显式访问 public.sys_user、public.sys_role、public.sys_config 时结构可正常读取。

因此若依登录、角色和配置等核心 Mapper 当前具备真实运行阻塞。该问题不能由“数据库支持 MySQL 函数”这一结论覆盖。

相关文件：

• ruoyi-system/src/main/resources/mapper/system/SysUserMapper.xml
• ruoyi-system/src/main/resources/mapper/system/SysRoleMapper.xml
• ruoyi-system/src/main/resources/mapper/system/SysConfigMapper.xml

5. generated keys 与 identity/sequence

当前6张数字主键业务表的主键实际为 bigint GENERATED BY DEFAULT AS IDENTITY，数据库目录能够识别对应内部 sequence。JDBC 元数据结果：

• IS_AUTOINCREMENT=YES；
• 驱动声明 supportsGetGeneratedKeys=true。

这说明 MyBatis useGeneratedKeys 具备数据库和驱动基础条件。由于实际插入会修改数据，本阶段没有执行 INSERT，也不能确认所有 Mapper 的生成键回填行为。该项分类为“基础条件满足，完整行为无法只读确认”。

6. 分类结论

当前实例直接支持

• current_database()；
• LIMIT ... OFFSET ...；
• 标准只读事务与系统目录查询；
• identity/sequence 元数据读取。

兼容模式支持

• date_format；
• ifnull；
• find_in_set；
• sysdate()；
• MySQL 风格 LIMIT offset,row_count；
• DUAL；
• 反引号标识符。

明确不支持

本次指定且可安全执行的语法项中，没有发现当前实例明确不支持的项。

无法只读确认

• MyBatis 在真实 INSERT 场景中的 generated keys 回填；
• PageHelper 对全部复杂 Mapper SQL 的改写和计数行为；
• 触发器、批量写入、导入导出等写链路的完整兼容性。

已确认但不属于语法缺失的问题

• 代码生成器以 current_database() 过滤 table_schema，当前返回空结果；
• 未限定 schema 的若依 sys_* Mapper 命中 Kingbase 系统视图，核心账号与权限查询会失败。

7. Phase 0判断

当前 Kingbase MySQL 兼容模式覆盖了项目已识别的主要 MySQL 函数和分页形式，但项目不能据此视为“已完成 Kingbase 适配”。数据库 V2 前应先确定 schema 解析策略、系统表访问策略和生成键集成验证方案；本报告只记录现状，不提出或实施源码、配置、数据库结构修复。