JeecgBoot主附表多主键配置问题解析

问题背景

在使用JeecgBoot 3.7.2版本开发过程中，开发者遇到了主附表关系配置的特殊情况：主表除了默认的ID主键外，还设置了"人员编号"作为另一个主键字段。当在子表中配置外键关联这个"人员编号"字段时，系统却错误地显示了主表ID的值，而非预期的"人员编号"值。

技术原理分析

JeecgBoot的在线代码生成功能对主附表关系有明确的规则要求：

1. 主键识别规则：系统默认将主表的ID字段作为主键，当需要引用其他主键时，需要遵循特定命名规范

2. 外键命名规范：

   • 如果引用的是主表默认ID主键，外键字段名必须以"_ID"结尾
   • 如果引用的是主表其他主键字段，同样需要遵循特定命名规则

3. 字段对应规则：主表和子表的外键字段名称必须保持一致（除主键ID外）

问题复现与解决方案

根据问题描述，开发者遇到的具体情况是：

1. 主表结构：

   • 默认主键：id
   • 附加主键：人员编号（如well_name）

2. 子表结构：

   • 外键字段：试图关联主表的well_name字段

错误配置表现： 子表中外键字段显示的是主表id值，而非预期的well_name值

正确配置方法：

1. 确保主表的附加主键字段已正确设置为主键属性

2. 子表外键字段命名：

   • 必须与主表主键字段名完全一致
   • 建议采用"主表字段名_ID"的格式命名

3. 数据库层面：

   • 确认主表附加主键的唯一性约束
   • 检查外键约束是否正确定义

最佳实践建议

1. 单一主键原则：尽量避免使用多主键设计，除非业务场景确实需要

2. 命名一致性：主附表关联字段应保持完全一致的命名

3. 外键后缀：即使引用非ID主键，也建议使用"_ID"后缀以符合框架规范

4. 测试验证：配置完成后，应通过单元测试验证关联关系是否正确

总结

JeecgBoot框架对主附表关系有明确的规范要求，特别是在处理非标准主键引用时，开发者需要特别注意字段命名规则和关联一致性。通过遵循框架设计规范，可以避免此类关联显示错误的问题，确保系统数据关系的正确性。