Jeecg-Boot主附表多主键配置问题解析

问题背景

在使用Jeecg-Boot 3.7.2版本开发过程中，开发者遇到了主附表关系配置的特殊情况：主表除了默认的ID主键外，还设置了"人员编号"作为第二个主键。在配置子表外键关联时，期望子表显示主表的"人员编号"值，但实际显示的是主表的ID值。

技术原理分析

Jeecg-Boot的主附表关系设计遵循以下原则：

1. 主键关联机制：系统默认使用主表的ID字段作为关联外键的基础
2. 命名规范：子表引用主表主键的外键字段必须以"_ID"结尾
3. 字段一致性：主表和子表的外键字段名称必须保持一致（除主键ID外）

问题根源

当主表存在多个主键时，系统默认仍会使用ID主键作为关联依据。即使开发者配置了其他主键作为关联字段，系统仍会优先使用ID字段进行关联，这导致了显示值与预期不符的问题。

解决方案

针对这种多主键场景，建议采用以下配置方法：

1. 字段命名规范：确保子表的外键字段以"_ID"结尾
2. 字段一致性：主表的第二个主键字段名与子表的外键字段名保持一致
3. 代码生成配置：在在线代码生成器中明确指定关联字段

配置示例

以井信息管理为例：

1. 主表结构：

   • ID（主键）
   • WELL_CODE（井编号，主键）
   • WELL_NAME（井名称）

2. 子表结构：

   • ID（主键）
   • WELL_CODE_ID（外键，关联主表WELL_CODE）
   • HISTORY_DATA（历史数据）

3. 配置要点：

   • 确保WELL_CODE在主表中被标记为主键
   • 子表外键字段必须命名为WELL_CODE_ID
   • 在代码生成器中明确选择WELL_CODE作为关联字段

注意事项

1. 系统对多主键场景的支持有限，建议优先使用单一主键
2. 如需使用多主键，建议通过自定义SQL或业务逻辑实现复杂关联
3. 在配置完成后，务必检查生成的实体类中的@TableField注解是否正确

通过以上配置方法，可以解决主附表多主键场景下的外键显示问题，确保系统按照预期展示关联字段的值。