cykj/hzdyjs

0 Fork 0

Files

T

wuzhen 6820ebc45f wuzhen 提交代码

2025-07-16 18:11:31 +08:00

5.5 KiB

Raw Blame History

学生信息家庭信息父母信息特殊情况字段修复记录

修复概述

修复时间: 2025-01-03 14:30:00
修复人员: Cursor AI Assistant
问题描述: 学生信息管理系统中，家庭信息的父母信息和特殊情况字段在详情页面不显示
修复结果: ✅ 修复成功

问题分析

根本原因

Mapper查询字段缺失: XgStudentInfoMapper.xml 中的 selectVoPage 查询语句缺少父母信息和特殊情况字段
前端字段名称错误: 详情页面中部分字段名称与后端实体类不一致

具体问题

缺失的父母信息字段:
- father_name (父亲姓名)
- father_phone (父亲电话)
- father_work_unit (父亲工作单位)
- mother_name (母亲姓名)
- mother_phone (母亲电话)
- mother_work_unit (母亲工作单位)
缺失的特殊情况字段:
- is_minority (少数民族)
- is_disabled (残疾学生)
- is_orphan (孤儿)
- is_left_behind_child (留守儿童)
- is_single_child (独生子女)
前端字段名称错误:
- isFromPoorFamily → isPoorStudent
- isLeftBehind → isLeftBehindChild
- isOnlyChild → isSingleChild

修复内容

1. 后端Mapper修复

文件: backend/ruoyi-modules/ruoyi-xg-xx/src/main/resources/mapper/xg/XgStudentInfoMapper.xml

修复前:

SELECT
    id, student_no, name, gender, birth_date, phone, email,
    id_card, nationality, political_status, major_name, class_name,
    grade, college_name, dormitory_building, dormitory_room, photo_path, guardian_name,
    guardian_phone, guardian_relation, emergency_contact_name,
    emergency_contact_phone, emergency_contact_relation,
    enrollment_date, student_status, remark,
    create_by, create_time, update_by, update_time,
    deleted, tenant_id, counselor_id, class_teacher_id,
    home_address, bank_card_no, bank_name, is_poor_student,
    health_status, specialties, family_income,
    social_activities, awards, violations,
    info_status, data_source, last_batch_id, last_audit_time,
    is_complete, completion_rate, ext_field1, ext_field2, ext_field3, ext_field4, ext_field5
FROM xg_student_info

修复后:

SELECT
    id, student_no, name, gender, birth_date, phone, email,
    id_card, nationality, political_status, major_name, class_name,
    grade, college_name, dormitory_building, dormitory_room, photo_path, guardian_name,
    guardian_phone, guardian_relation, emergency_contact_name,
    emergency_contact_phone, emergency_contact_relation,
    enrollment_date, student_status, remark,
    create_by, create_time, update_by, update_time,
    deleted, tenant_id, counselor_id, class_teacher_id,
    home_address, bank_card_no, bank_name, 
    -- 父母信息字段
    father_name, father_phone, father_work_unit,
    mother_name, mother_phone, mother_work_unit,
    -- 特殊情况字段
    is_poor_student, is_minority, is_disabled, is_orphan, is_left_behind_child, is_single_child,
    health_status, specialties, family_income,
    social_activities, awards, violations,
    info_status, data_source, last_batch_id, last_audit_time,
    is_complete, completion_rate, ext_field1, ext_field2, ext_field3, ext_field4, ext_field5
FROM xg_student_info

2. 前端详情页面修复

文件: web/src/views/xg-xx/studentInfo/components/StudentDetailDialog.vue

修复内容:

isFromPoorFamily → isPoorStudent
isLeftBehind → isLeftBehindChild
isOnlyChild → isSingleChild

验证结果

1. 数据库字段验证

✅ 所有父母信息字段存在于数据库表中
✅ 所有特殊情况字段存在于数据库表中
✅ ResultMap映射配置正确

2. 后端实体类验证

✅ 实体类包含所有必要字段
✅ @TableField注解配置正确
✅ VO类字段定义完整

3. 前端页面验证

✅ 编辑页面字段名称正确
✅ 详情页面字段名称已修复
✅ 字段绑定关系正确

测试验证

测试脚本

创建了验证脚本: test/学生信息家庭信息父母信息特殊情况字段修复验证.sql

验证步骤

执行数据库查询验证字段数据
测试后端API返回数据完整性
验证前端页面字段显示正确性

影响范围

修复影响

✅ 学生信息详情页面现在能正确显示父母信息
✅ 学生信息详情页面现在能正确显示特殊情况信息
✅ 数据录入和查询功能正常
✅ 不影响其他功能模块

后续建议

1. 质量保证

建议定期检查Mapper查询语句与实体类字段的一致性
建议在代码审查时特别关注字段名称的一致性

2. 开发规范

前后端字段命名应保持一致
新增字段时应同时更新相关的查询语句
建议使用工具自动检查字段映射关系

3. 测试完善

建议增加字段完整性的自动化测试
建议在功能测试中包含数据显示完整性验证

总结

本次修复解决了学生信息管理系统中家庭信息和特殊情况字段不显示的问题。问题的根本原因是Mapper查询语句中缺少相关字段，以及前端页面字段名称不一致。通过系统性的分析和修复，确保了数据的完整性和页面显示的正确性。

修复后，用户可以正常查看学生的父母信息和特殊情况信息，提升了系统的功能完整性和用户体验。

5.5 KiB Raw Blame History