Jeecg-Boot 3.7.1版本中sys_gateway_route表缺失del_flag字段问题解析

问题背景

在Jeecg-Boot 3.7.1版本中，部分用户在使用网关路由功能时遇到了数据库查询错误。错误信息显示系统尝试查询sys_gateway_route表中的del_flag字段，但该字段在数据库中并不存在，导致SQL执行失败。

错误现象

当系统执行网关路由相关查询时，会抛出以下异常：

Error querying database. Cause: java.sql.SQLSyntaxErrorException: Unknown column 'del_flag' in 'field list'

具体错误SQL为：

SELECT id, router_id, name, uri, predicates, filters, strip_prefix, retryable, persistable, show_api, status, create_by, create_time, del_flag 
FROM sys_gateway_route 
WHERE del_flag = 0

问题原因分析

1. 逻辑删除机制：Jeecg-Boot框架普遍采用逻辑删除机制，通过del_flag字段标记记录是否被删除（0表示未删除，1表示已删除）

2. 表结构不完整：sys_gateway_route表在设计时可能遗漏了del_flag字段，导致框架默认的逻辑删除查询无法执行

3. 版本差异：该问题在早期版本的Jeecg-Boot中存在，但在最新代码中已经修复

解决方案

对于遇到此问题的用户，有以下两种解决方法：

方法一：执行增量SQL

可以通过执行以下SQL语句为sys_gateway_route表添加del_flag字段：

ALTER TABLE sys_gateway_route ADD COLUMN del_flag tinyint(1) DEFAULT 0 COMMENT '逻辑删除标记(0:未删除,1:已删除)';

方法二：升级到最新版本

Jeecg-Boot的最新版本已经修复了这个问题，建议用户升级到最新版本以获得完整的解决方案。

技术建议

1. 数据库版本控制：建议开发团队在项目中使用Flyway或Liquibase等数据库版本控制工具，确保表结构与代码保持一致

2. 字段标准化：对于框架核心表，应确保包含标准字段（如del_flag、create_time、update_time等）

3. 升级策略：用户在使用开源框架时，应定期关注版本更新，及时获取最新的修复和改进

总结

该问题属于Jeecg-Boot 3.7.1版本中的一个已知缺陷，通过简单的SQL修改或版本升级即可解决。对于企业级应用开发而言，保持框架和数据库结构的完整性至关重要，建议开发者在项目初期就建立完善的数据库变更管理机制。