JeecgBoot项目中sys_announcement_send表主键缺失问题分析

问题背景

在JeecgBoot 3.7.1版本中，系统公告发送记录表(sys_announcement_send)存在一个设计缺陷。该表在实体类中定义了id字段作为主键，但在数据库建表SQL中却未将id字段设置为主键。这种不一致性导致了系统在并发操作时可能出现死锁问题。

问题表现

当多个用户同时调用/editByAnntIdAndUserId接口时，由于表结构缺少主键约束，MySQL数据库会产生死锁。从错误日志中可以看到，两个事务互相等待对方持有的锁资源，导致系统无法继续执行。

技术分析

死锁产生原因

1. 索引缺失：没有主键的表在InnoDB引擎中会使用隐式的聚簇索引(GEN_CLUST_INDEX)，这会影响查询性能并增加锁冲突的可能性。

2. 并发控制失效：缺少明确的主键定义使得数据库无法有效地管理行级锁，导致多个事务可能同时尝试修改相同的数据行。

3. 锁升级：在没有合适索引的情况下，数据库可能会将行锁升级为表锁，大大增加了死锁的概率。

错误日志解读

从错误日志中可以看到：

• 事务1正在尝试更新公告阅读状态，持有X锁但等待获取另一个X锁
• 事务2同样在更新公告阅读状态，持有事务1需要的锁资源
• 两个事务互相等待对方释放锁资源，形成死锁循环

解决方案

项目维护者提供了直接的SQL修复方案：

ALTER TABLE `sys_announcement_send` 
MODIFY COLUMN `id` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL FIRST,
ADD PRIMARY KEY (`id`);

这条SQL语句执行两个操作：

1. 确保id字段为非空并调整位置
2. 将id字段设置为主键

预防措施

为避免类似问题，建议开发团队：

1. 建立数据库设计规范：确保实体类与数据库表结构严格一致
2. 实施代码审查：在合并数据库变更前进行双重检查
3. 使用自动化工具：可以通过数据库迁移工具(如Flyway)管理表结构变更
4. 添加完整性检查：在持续集成流程中加入数据库结构验证步骤

总结

数据库表设计中的主键定义看似简单，但对系统并发性能和稳定性有着重要影响。JeecgBoot项目中发现的这个问题提醒我们，在快速开发框架中也不能忽视基础数据库设计的重要性。通过及时修复这一问题，可以显著提高系统在高并发场景下的稳定性。