智慧教务系统

5.2 KiB

Raw Blame History

课程安排学员显示修复说明

🔍 问题描述

在 pages/market/clue/class_arrangement 页面中，调用 /api/course/courseAllList?schedule_date=2025-08-01 接口时，课程安排中的学员信息显示不正确：

应该显示一个正式学员和一个等待位学员
实际只显示了一个学员，另一个学员没有在列表中显示

📊 数据库分析

1. 课程安排数据

SELECT id, course_date, time_slot FROM school_course_schedule WHERE course_date = '2025-08-01';
-- 结果：
-- id=124, course_date='2025-08-01', time_slot='09:00-10:00'
-- id=154, course_date='2025-08-01', time_slot='10:00-11:00'

2. 学员安排数据

SELECT pcs.*, cr.name FROM school_person_course_schedule pcs 
LEFT JOIN school_customer_resources cr ON pcs.resources_id = cr.id 
WHERE pcs.schedule_id = 124;
-- 结果：
-- id=73, resources_id=5, schedule_type=1, course_type=1, name='测试' (正式学员)
-- id=74, resources_id=31, schedule_type=2, course_type=3, name='美团01' (等待位学员)

3. 关联数据问题

SELECT cr.id, cr.name, cr.member_id, sm.member_id, sm.headimg 
FROM school_customer_resources cr 
LEFT JOIN school_member sm ON cr.member_id = sm.member_id 
WHERE cr.id IN (5, 31);
-- 结果：
-- id=5, name='测试', member_id=2, sm.member_id=2, headimg='...' ✅
-- id=31, name='美团01', member_id=0, sm.member_id=NULL, headimg=NULL ❌

问题根源：美团01 的 member_id 为 0，在 JOIN school_member 表时没有匹配到数据，导致整条记录被过滤掉。

🔧 修复方案

原始代码问题

// CourseService.php 第398-407行（修复前）
$student = Db::name('person_course_schedule')
    ->alias('pcs')
    ->where('pcs.schedule_id', $v['id'])
    ->join('school_student st', 'pcs.student_id = st.id')  // ❌ student_id为NULL
    ->join('school_customer_resources cr', 'st.user_id = cr.id')
    ->join('school_member sm', 'cr.member_id = sm.member_id')  // ❌ INNER JOIN过滤掉member_id=0的记录
    ->field('st.name, sm.headimg as avatar')
    ->select();

修复后代码

// CourseService.php 第397-407行（修复后）
$student = Db::name('person_course_schedule')
    ->alias('pcs')
    ->where('pcs.schedule_id', $v['id'])
    ->leftJoin('school_customer_resources cr', 'pcs.resources_id = cr.id')  // ✅ 使用resources_id
    ->leftJoin('school_member sm', 'cr.member_id = sm.member_id AND cr.member_id > 0')  // ✅ LEFT JOIN + 条件
    ->field('cr.name, COALESCE(sm.headimg, "") as avatar, pcs.schedule_type, pcs.course_type, pcs.status')
    ->select();

🎯 修复要点

1. 字段关联修复

原来：通过 pcs.student_id = st.id 关联（但 student_id 为 NULL）
修复：通过 pcs.resources_id = cr.id 关联（正确的关联字段）

2. JOIN类型修复

原来：使用 join() (INNER JOIN)，过滤掉不匹配的记录
修复：使用 leftJoin() (LEFT JOIN)，保留所有记录

3. member_id处理

原来：cr.member_id = sm.member_id 直接关联
修复：cr.member_id = sm.member_id AND cr.member_id > 0 条件关联

4. 字段处理

原来：sm.headimg as avatar
修复：COALESCE(sm.headimg, "") as avatar 处理NULL值

5. 增加字段

添加 pcs.schedule_type：区分正式位(1)和等待位(2)
添加 pcs.course_type：区分正式课(1)、体验课(2)、等待位(3)
添加 pcs.status：学员状态信息

📋 测试结果

修复前

{
  "student": [
    {
      "name": "测试",
      "avatar": "https://...",
      "schedule_type": 1,
      "course_type": 1,
      "status": 0
    }
    // 缺少"美团01"学员
  ]
}

修复后

{
  "student": [
    {
      "name": "测试",
      "avatar": "https://...",
      "schedule_type": 1,
      "course_type": 1,
      "status": 0
    },
    {
      "name": "美团01",
      "avatar": "",
      "schedule_type": 2,
      "course_type": 3,
      "status": 0
    }
  ]
}

🔍 数据字段说明

schedule_type 字段

1 - 正式位
2 - 等待位

course_type 字段

1 - 正式课
2 - 体验课
3 - 等待位

status 字段

0 - 正常
1 - 已取消
2 - 已完成

🎯 技术总结

问题类型

数据关联错误：使用了错误的关联字段
JOIN类型错误：INNER JOIN 过滤掉了部分数据
数据完整性问题：member_id 为 0 的记录处理不当

修复原则

使用正确的关联字段：resources_id 而不是 student_id
使用LEFT JOIN：保证所有学员记录都能显示
处理NULL值：使用 COALESCE 处理可能的空值
增加业务字段：提供更多有用的业务信息

最佳实践

数据库设计：确保关联字段的一致性
查询优化：根据实际数据结构选择合适的JOIN类型
异常处理：考虑数据不完整的情况
字段完整性：提供前端需要的所有业务字段

修复完成时间：2025-07-31
状态：✅ 问题已修复，学员显示正常
影响范围：课程安排页面的学员列表显示

5.2 KiB Raw Blame History