JeecgBoot项目中sys_announcement_send表主键缺失问题分析与解决方案

问题背景

在JeecgBoot 3.7.1版本中，系统公告发送记录表sys_announcement_send存在一个潜在的设计缺陷。该表在SQL建表语句中没有明确定义主键，但在对应的Java实体类中却定义了id字段作为主键。这种不一致性导致了数据库操作时可能出现死锁问题。

问题现象

当用户多次调用/editByAnntIdAndUserId接口时，由于表结构缺少主键约束，MySQL数据库会产生死锁。从错误日志中可以看到，两个事务同时尝试更新同一用户的公告记录时，会互相等待对方持有的锁资源，最终导致死锁发生。

技术分析

死锁产生原因

1. 表结构缺陷：sys_announcement_send表没有定义主键，MySQL会隐式创建一个聚集索引（GEN_CLUST_INDEX），这会影响查询和更新操作的性能。

2. 索引使用：从错误日志可以看出，事务使用了idx_sacm_user_id索引，但由于缺少主键，锁竞争变得更加复杂。

3. 并发控制：当多个事务同时操作同一用户的公告记录时，由于没有明确的主键约束，锁的粒度变大，增加了死锁概率。

影响范围

此问题主要影响：

• 公告阅读状态的更新操作
• 高并发场景下的系统稳定性
• 数据库性能

解决方案

修复方案

为sys_announcement_send表添加主键约束，执行以下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`);

实施建议

1. 生产环境：建议在业务低峰期执行此变更，避免影响线上服务。

2. 版本升级：对于新部署的JeecgBoot系统，建议在初始化数据库后立即执行此修复。

3. 代码审查：检查所有涉及sys_announcement_send表的业务逻辑，确保与主键相关的操作正确。

预防措施

为避免类似问题再次发生，建议：

1. 数据库设计规范：确保表结构与实体类定义保持一致，特别是主键约束。

2. 代码审查流程：在数据库变更时，同时检查对应的实体类定义。

3. 性能测试：对高并发场景下的关键表操作进行压力测试，提前发现潜在问题。

总结

数据库表设计是系统稳定性的基础，主键缺失看似小问题，但在高并发场景下可能导致严重的性能问题和系统不稳定。JeecgBoot项目中的这个案例提醒我们，在数据库设计和实现过程中，必须保持严谨的态度，确保表结构与业务逻辑的一致性。通过及时修复此问题，可以显著提升系统的稳定性和并发处理能力。