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

在JeecgBoot 3.7.2版本中，当开发者配置主附表关系时，如果主表存在多个主键字段，可能会遇到外键显示值不正确的问题。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象

当主表除了默认的ID主键外，还设置了其他字段作为主键（如人员编号、井名等），在配置子表外键关系时，子表中外键字段显示的值不是预期的附加主键值，而是主表ID的值。

问题原因分析

JeecgBoot框架对于主附表关系有以下核心规则：

1. 默认情况下，系统会以主表的ID字段作为关联外键
2. 当需要关联其他主键字段时，必须遵循特定的命名规范
3. 子表外键字段的命名必须与主表对应字段保持严格一致

解决方案

正确配置步骤

1. 主表配置：确保主表已正确设置多个主键字段，例如ID和井名(WELL_NAME)

2. 子表外键字段命名：

   • 必须以"_ID"结尾
   • 字段名必须与主表对应字段名相同（除ID外）
   • 例如主表有WELL_NAME字段，子表外键应命名为WELL_NAME_ID

3. 数据库设计：

   • 主表：包含ID和WELL_NAME字段，两者都设为主键
   • 子表：包含WELL_NAME_ID字段作为外键

4. 代码生成器配置：

   • 在在线表单配置中明确指定外键关联字段
   • 确保子表模型类中外键字段注解正确

常见错误修正

1. 命名不规范：

   • 错误：子表使用wellName作为外键字段名
   • 正确：应使用WELL_NAME_ID

2. 类型不匹配：

   • 确保子表外键字段类型与主表对应字段类型一致

3. 注解缺失：

   • 子表模型类中外键字段需要添加@TableField和@Excel注解

最佳实践建议

1. 对于多主键关联，建议在数据库层面建立外键约束
2. 在实体类中使用@JoinColumn注解明确指定关联关系
3. 考虑使用框架提供的@TableId注解标注复合主键
4. 在业务逻辑层添加验证，确保数据一致性

通过遵循上述规范和解决方案，开发者可以正确配置JeecgBoot中的多主键主附表关系，确保外键值显示正确，系统运行稳定。