cykj/hzdyjs
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
e79bf5a26c2b9c66d1a1cd38ba6448e9bbeaa529
hzdyjs/出国申请字段映射问题修复报告.md
T
weizhong e79bf5a26c “编译修改”
2025-10-14 16:41:19 +08:00

17 KiB
Raw Blame History

出国申请字段映射问题修复报告

修复时间

2025-10-08

问题描述

用户报告：通过出国申请菜单中的新增申请弹窗填写的内容，只有applicant_name、department、destination、itinerary几个字段能保存到数据库，而professionalTitle、exit_reason、visit_relationship等字段在前端填写后，数据库rs_overseas_application表中仍然显示为NULL。

根本原因分析

经过全面分析，发现问题出在三个层次：

1. Bo/Vo类缺少字段定义（已修复）

RsOverseasApplicationBo.java和RsOverseasApplicationVo.java缺少7个数据库字段的定义。

2. Service层缺少字段映射（核心问题）🔴

关键发现：即使Bo类有字段定义，Service层的buildEntityFromBo方法也没有进行字段映射，导致数据无法从Bo对象传递到Entity对象。

查看RsOverseasApplicationServiceImpl.java：

  • buildEntityFromBo方法（第540行）：负责新增时将Bo转换为Entity
  • updateByBo方法（第206行）：负责修改时更新Entity字段

这两个方法中都缺少了7个字段的映射代码，这就是数据无法保存的根本原因！

3. 前端字段命名（无问题）✅

前端表单字段命名完全正确，与后端Bo类字段名一致。

数据流程分析

❌ 修复前的数据流程（问题状态）

前端提交:
{
  professionalTitle: "副教授",
  exitReason: "旅游",
  documentName: "护照"
  ...
}
    ↓
Controller接收: RsOverseasApplicationBo对象
{
  professionalTitle: "副教授" ✅ 接收成功
  exitReason: "旅游" ✅ 接收成功
  ...
}
    ↓
Service层: buildEntityFromBo(bo)
{
  // ❌ 缺少字段映射代码
  // entity.setProfessionalTitle(bo.getProfessionalTitle());  // 缺失！
  // entity.setExitReason(bo.getExitReason());  // 缺失！
  ...
}
    ↓
Entity对象:
{
  professionalTitle: null  ❌ 未映射
  exitReason: null  ❌ 未映射
  ...
}
    ↓
数据库INSERT:
rs_overseas_application表中字段为NULL ❌

✅ 修复后的数据流程（预期状态）

前端提交:
{
  professionalTitle: "副教授",
  exitReason: "旅游",
  documentName: "护照"
  ...
}
    ↓
Controller接收: RsOverseasApplicationBo对象
{
  professionalTitle: "副教授" ✅
  exitReason: "旅游" ✅
  ...
}
    ↓
Service层: buildEntityFromBo(bo)
{
  entity.setProfessionalTitle(bo.getProfessionalTitle());  ✅ 已添加
  entity.setExitReason(bo.getExitReason());  ✅ 已添加
  entity.setDocumentName(bo.getDocumentName());  ✅ 已添加
  entity.setDocumentNumber(bo.getDocumentNumber());  ✅ 已添加
  entity.setDestinationCountry(bo.getDestinationCountry());  ✅ 已添加
  entity.setVisitRelationship(bo.getVisitRelationship());  ✅ 已添加
  entity.setRemarks(bo.getRemarks());  ✅ 已添加
}
    ↓
Entity对象:
{
  professionalTitle: "副教授"  ✅ 映射成功
  exitReason: "旅游"  ✅ 映射成功
  ...
}
    ↓
数据库INSERT:
professional_title = "副教授"  ✅
exit_reason = "旅游"  ✅
document_name = "护照"  ✅
...所有字段正确保存  ✅

修复内容

缺失的7个字段

序号 Java字段名 数据库字段 说明 优先级
1 professionalTitle professional_title 职称 🔴 高
2 documentName document_name 申领证件名称 🔴 高
3 documentNumber document_number 证件号码 🔴 高
4 destinationCountry destination_country 前往国家 🔴 高
5 exitReason exit_reason 出境事由（旅游/探亲） 🔴 高
6 visitRelationship visit_relationship 探望对象姓名及关系 🟡 中
7 remarks remarks 备注 🟡 中

修复的文件

1. RsOverseasApplicationBo.java ✅

  • 文件路径：backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/bo/RsOverseasApplicationBo.java
  • 修复内容：添加了7个缺失字段的定义和注释

2. RsOverseasApplicationVo.java ✅

  • 文件路径：backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/vo/RsOverseasApplicationVo.java
  • 修复内容：添加了7个缺失字段的定义和注释

3. RsOverseasApplicationServiceImpl.java ✅（核心修复）

  • 文件路径：backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/service/impl/RsOverseasApplicationServiceImpl.java
  • 修复内容：

① buildEntityFromBo方法（第540-576行）

private RsOverseasApplication buildEntityFromBo(RsOverseasApplicationBo bo) {
    RsOverseasApplication entity = new RsOverseasApplication();
    // ... 原有字段映射 ...
    
    // 新增：7个字段的映射
    entity.setPosition(bo.getPosition());
    entity.setProfessionalTitle(bo.getProfessionalTitle());  // 职称
    entity.setDestinationCountry(bo.getDestinationCountry());  // 前往国家
    entity.setDocumentName(bo.getDocumentName());  // 申领证件名称
    entity.setDocumentNumber(bo.getDocumentNumber());  // 证件号码
    entity.setExitReason(bo.getExitReason());  // 出境事由
    entity.setVisitRelationship(bo.getVisitRelationship());  // 探望对象关系
    entity.setRemarks(bo.getRemarks());  // 备注
    
    return entity;
}

② updateByBo方法（第206-245行）

// 只设置非null字段
if (update.getPosition() != null) updateWrapper.set(...);
if (update.getProfessionalTitle() != null) updateWrapper.set(...);  // 职称
if (update.getDestinationCountry() != null) updateWrapper.set(...);  // 前往国家
if (update.getDocumentName() != null) updateWrapper.set(...);  // 申领证件名称
if (update.getDocumentNumber() != null) updateWrapper.set(...);  // 证件号码
if (update.getExitReason() != null) updateWrapper.set(...);  // 出境事由
if (update.getVisitRelationship() != null) updateWrapper.set(...);  // 探望对象关系
if (update.getRemarks() != null) updateWrapper.set(...);  // 备注

前端字段验证

通过grep搜索，确认前端表单字段命名完全正确：

<!-- 前端表单字段定义 - web/src/views/rs/overseas/index.vue -->
<el-form-item label="职称" prop="professionalTitle">
  <el-input v-model="applicationForm.professionalTitle" />
</el-form-item>

<el-form-item label="申领证件名称" prop="documentName">
  <el-input v-model="applicationForm.documentName" />
</el-form-item>

<el-form-item label="证件号码" prop="documentNumber">
  <el-input v-model="applicationForm.documentNumber" />
</el-form-item>

<el-form-item label="前往国家" prop="destinationCountry">
  <el-input v-model="applicationForm.destinationCountry" />
</el-form-item>

<el-form-item label="出境事由" prop="exitReason">
  <el-radio-group v-model="applicationForm.exitReason">
    <el-radio label="旅游">旅游</el-radio>
    <el-radio label="探亲">探亲</el-radio>
  </el-radio-group>
</el-form-item>

<el-form-item label="探望对象关系" prop="visitRelationship" v-if="applicationForm.exitReason === '探亲'">
  <el-input v-model="applicationForm.visitRelationship" />
</el-form-item>

<el-form-item label="备注" prop="remarks">
  <el-input v-model="applicationForm.remarks" type="textarea" />
</el-form-item>

✅ 前端字段命名与后端Bo类完全一致，无需修改。

修复验证

语法检查

✅ 所有Java文件已通过语法检查，无编译错误

需要执行的测试步骤

1. 重启后端服务 🔴 必须

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend
mvn clean install
# 然后重启后端服务

2. 新增申请测试

  1. 登录系统
  2. 进入"出国申请"菜单
  3. 点击"新增申请"按钮
  4. 填写完整表单：
    • ✅ 姓名：张三
    • ✅ 现工作部门：计算机学院
    • ✅ 职称：副教授 ⬅️ 测试字段
    • ✅ 申领证件名称：护照 ⬅️ 测试字段
    • ✅ 证件号码：E12345678 ⬅️ 测试字段
    • ✅ 前往国家：美国 ⬅️ 测试字段
    • ✅ 出境事由：旅游 ⬅️ 测试字段
    • ✅ 探望对象关系：（如选探亲）父亲张某 ⬅️ 测试字段
    • ✅ 备注：参加学术会议 ⬅️ 测试字段
  5. 提交申请
  6. 查询数据库验证

3. 数据库验证SQL

-- 查询最新一条出国申请记录，验证7个字段是否正确保存
SELECT 
    application_id,
    applicant_name,
    department,
    professional_title,      -- ⬅️ 应该显示"副教授"
    document_name,            -- ⬅️ 应该显示"护照"
    document_number,          -- ⬅️ 应该显示"E12345678"
    destination_country,      -- ⬅️ 应该显示"美国"
    exit_reason,              -- ⬅️ 应该显示"旅游"
    visit_relationship,       -- ⬅️ 探亲时应该显示"父亲张某"
    remarks,                  -- ⬅️ 应该显示"参加学术会议"
    status,
    create_time
FROM rs_overseas_application
ORDER BY create_time DESC
LIMIT 1;

预期结果：

professional_title     = "副教授"         ✅ 不应为NULL
document_name          = "护照"           ✅ 不应为NULL
document_number        = "E12345678"      ✅ 不应为NULL
destination_country    = "美国"           ✅ 不应为NULL
exit_reason            = "旅游"           ✅ 不应为NULL
visit_relationship     = "父亲张某"       ✅ 探亲时不应为NULL
remarks                = "参加学术会议"   ✅ 不应为NULL

4. 修改申请测试

  1. 编辑已有申请
  2. 修改职称从"副教授"改为"教授"
  3. 修改出境事由从"旅游"改为"探亲"
  4. 填写探望对象关系"母亲李某"
  5. 保存修改
  6. 查询数据库验证字段是否正确更新

5. 查看详情测试

  1. 查看申请详情页面
  2. 验证所有7个字段是否正确显示

修复影响范围

直接影响

  • ✅ 新增申请功能：7个字段现在可以正确保存到数据库
  • ✅ 修改申请功能：7个字段现在可以正确更新到数据库
  • ✅ 查看详情功能：7个字段现在可以正确从数据库读取并显示

间接影响

  • ✅ 出国登记生成：依赖申请数据的字段现在完整可用
  • ✅ 审批流程：审批人员可以看到完整的申请信息
  • ✅ 报表统计：统计功能可以访问到完整的数据
  • ✅ 数据导出：导出的数据现在更加完整

技术要点

1. Spring Boot字段映射机制

虽然项目使用了MapStruct的@AutoMapper注解，但在某些情况下需要手动编写映射代码：

@AutoMapper(target = RsOverseasApplication.class, reverseConvertGenerate = false)
public class RsOverseasApplicationBo extends BaseEntity

问题：MapStruct的自动映射在Service层的手动转换方法中不生效。

解决方案：在buildEntityFromBo手动方法中显式调用setter方法进行字段映射。

2. 新增字段的完整修复清单

对于新增的数据库字段，需要在以下位置进行修改：

  • ✅ Entity类（RsOverseasApplication.java） - 已存在
  • ✅ Bo类（RsOverseasApplicationBo.java） - 已添加
  • ✅ Vo类（RsOverseasApplicationVo.java） - 已添加
  • ✅ Service层 buildEntityFromBo方法 - 关键修复点
  • ✅ Service层 updateByBo方法 - 关键修复点
  • ✅ 前端表单字段定义 - 已存在
  • ✅ 前端表单验证规则 - 已存在

3. MyBatis-Plus更新机制

updateByBo方法使用LambdaUpdateWrapper进行动态字段更新：

// 只更新非null字段
if (update.getProfessionalTitle() != null) 
    updateWrapper.set(RsOverseasApplication::getProfessionalTitle, update.getProfessionalTitle());

优点：

  • 避免null值覆盖已有数据
  • 支持部分字段更新
  • 类型安全

注意事项

1. 已有数据处理

对于修复前已经提交的申请记录，这7个字段的值为NULL。

处理方案：

  • ✅ 推荐方案：让用户重新编辑并保存（Service层的updateByBo已修复）
  • ⚠️ 备选方案：通过SQL脚本批量设置默认值（需要业务确认）

2. 字段验证规则

当前添加的字段验证规则（见前端代码）：

// 前端验证规则
professionalTitle: [{ required: true, message: '职称不能为空', trigger: 'blur' }],
destinationCountry: [{ required: true, message: '前往国家不能为空', trigger: 'blur' }],
exitReason: [{ required: true, message: '出境事由不能为空', trigger: 'change' }],

部分字段为必填项，提交时会进行前端验证。

3. 后端验证

目前后端Bo类中这些字段没有添加@NotBlank等验证注解。如果需要后端强制验证，可以在Bo类中添加：

@NotBlank(message = "职称不能为空")
private String professionalTitle;

@NotBlank(message = "前往国家不能为空")
private String destinationCountry;

4. 条件字段处理

visitRelationship（探望对象关系）是条件字段：

  • 只有当exitReason为"探亲"时才需要填写
  • 前端已经实现了条件显示逻辑
  • 数据库允许为NULL

修复对比

修复项 修复前 修复后
Bo类字段定义 ❌ 缺少7个字段 ✅ 已添加7个字段
Vo类字段定义 ❌ 缺少7个字段 ✅ 已添加7个字段
buildEntityFromBo映射 ❌ 缺少7个字段映射 ✅ 已添加7个字段映射
updateByBo更新逻辑 ❌ 缺少7个字段更新 ✅ 已添加7个字段更新
前端字段命名 ✅ 正确 ✅ 正确
语法检查 - ✅ 通过
新增申请保存 ❌ 字段为NULL ✅ 字段正确保存
修改申请更新 ❌ 字段为NULL ✅ 字段正确更新
查看详情显示 ❌ 字段为NULL ✅ 字段正确显示

修复状态总结

任务 状态 说明
问题分析 ✅ 完成 定位到Service层缺少字段映射
Bo类修复 ✅ 完成 添加7个缺失字段，无语法错误
Vo类修复 ✅ 完成 添加7个缺失字段，无语法错误
Service层buildEntityFromBo ✅ 完成 添加7个字段映射逻辑
Service层updateByBo ✅ 完成 添加7个字段更新逻辑
前端字段验证 ✅ 完成 确认字段命名正确匹配
语法检查 ✅ 通过 Java编译器检查通过
后端重启 ⏳ 待执行 需要用户重启后端服务
功能测试 ⏳ 待执行 需要用户执行完整测试
数据验证 ⏳ 待执行 需要用户查询数据库验证

下一步行动

1. ⚠️ 必须重启后端服务（重要）

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend
mvn clean install
# 然后重启后端服务

2. 执行完整测试

  • 新增申请测试（填写完整表单）
  • 修改申请测试（修改已有申请）
  • 查看详情测试（验证字段显示）

3. 数据库验证

使用提供的SQL查询，验证7个字段是否正确保存

4. 反馈结果

如果测试发现问题，请提供：

  • 具体的错误信息
  • 后端日志
  • 前端控制台输出
  • 数据库查询结果截图

相关文档

技术总结

问题本质

字段映射缺失：虽然Bo类和前端都有字段定义，但Service层的buildEntityFromBo方法缺少了这些字段的映射代码，导致数据无法从Bo对象传递到Entity对象，最终无法保存到数据库。

核心修复

在Service层的两个关键方法中添加字段映射：

  1. buildEntityFromBo - 新增时的字段映射
  2. updateByBo - 修改时的字段更新

经验教训

  1. 字段映射必须完整：新增数据库字段时，除了Entity/Bo/Vo类，还必须在Service层的手动映射方法中添加对应代码
  2. 不能依赖自动映射：虽然有MapStruct注解，但在手动编写的转换方法中仍需显式映射
  3. 测试要全面：需要测试新增、修改、查看三个场景，确保字段在整个生命周期中都能正确处理

修复完成时间: 2025-10-08
修复执行者: Cursor AI Assistant
代码审查状态: ✅ 已通过语法检查
测试状态: ⏳ 待用户验证
预期效果: 修复后所有7个字段都能正确保存和更新

Reference in new issue View Git Blame Copy Permalink