# 第三阶段问题记录

## 问题记录格式
使用双链形式连接步骤文档，例如：[[第三阶段-核心功能完善和UniApp开发]]

## 问题列表

### 问题1
- **关联步骤**：[[第三阶段-核心功能完善和UniApp开发]]
- **问题描述**：插入学科分类时，数据库报错 `subject_name` 字段没有默认值
- **发生时间**：2025-11-11
- **错误信息**：
  ```
  Error updating database. Cause: java.sql.SQLException: Field 'subject_name' doesn't have a default value
  The error may exist in file [StudySubjectMapper.xml]
  The error may involve com.ddnai.system.mapper.study.StudySubjectMapper.insertSubject-Inline
  The error occurred while setting parameters
  SQL: insert into subject ( sort_order, status, create_by, create_time ) values ( ?, ?, ?, sysdate() )
  Cause: java.sql.SQLException: Field 'subject_name' doesn't have a default value
  ```
- **问题原因**：
  1. **根本原因**：前端表单使用的字段名与后端实体类不匹配
     - 前端使用：`name`、`code`
     - 后端期望：`subjectName`、`subjectCode`
     - 导致提交时 `subjectName` 为 `null`，后端接收不到数据
  2. **次要原因**：`StudySubjectMapper.xml` 中的 `insertSubject` 方法使用了条件判断 `<if test="subjectName != null and subjectName != ''">`
     - 当 `subjectName` 为空或 null 时，SQL 语句中不会包含 `subject_name` 字段
     - 但数据库表 `subject` 中的 `subject_name` 字段是必填的（NOT NULL 且没有默认值）
     - 因此当 `subjectName` 为空时，插入操作会失败
- **解决方案**：
  1. **修改 Mapper XML** (`StudySubjectMapper.xml`)：
     - 将 `subject_name` 字段从条件判断中移除，设为必填字段
     - 确保插入 SQL 始终包含 `subject_name` 字段
     ```xml
     <insert id="insertSubject" parameterType="StudySubject" useGeneratedKeys="true" keyProperty="id">
         insert into subject
         <trim prefix="(" suffix=")" suffixOverrides=",">
             subject_name,  <!-- 改为必填，不使用 if 判断 -->
             <if test="subjectCode != null and subjectCode != ''">subject_code,</if>
             ...
         </trim>
         <trim prefix="values (" suffix=")" suffixOverrides=",">
             #{subjectName},  <!-- 改为必填，不使用 if 判断 -->
             <if test="subjectCode != null and subjectCode != ''">#{subjectCode},</if>
             ...
         </trim>
     </insert>
     ```
  2. **添加 Service 层验证** (`StudySubjectServiceImpl.java`)：
     - 在 `insertSubject` 方法中添加验证逻辑
     - 如果 `subjectName` 为空，抛出异常，避免执行到数据库插入
     ```java
     @Override
     public int insertSubject(StudySubject subject)
     {
         // 验证必填字段
         if (StringUtils.isEmpty(subject.getSubjectName()))
         {
             throw new RuntimeException("学科名称不能为空");
         }
         return subjectMapper.insertSubject(subject);
     }
     ```
  3. **添加实体类验证注解** (`StudySubject.java`)：
     - 在 `getSubjectName()` 方法上添加 `@NotBlank` 注解
     - 添加 `@Size` 注解限制长度
     ```java
     @NotBlank(message = "学科名称不能为空")
     @Size(min = 0, max = 50, message = "学科名称不能超过50个字符")
     public String getSubjectName()
     {
         return subjectName;
     }
     ```
  4. **修复前端字段名** (`ruoyi-ui/src/views/study/subject/index.vue`)：
     - 将表单字段名从 `name`、`code` 改为 `subjectName`、`subjectCode`
     - 修改查询参数、表单数据、表格列、验证规则等所有相关字段名
     ```javascript
     // 修改前
     queryParams: { name: null }
     form: { name: null, code: null }
     
     // 修改后
     queryParams: { subjectName: null }
     form: { subjectName: null, subjectCode: null }
     ```
- **验证层级**：
  1. **Controller 层**：使用 `@Validated` 注解，自动验证实体类上的注解
  2. **Service 层**：手动验证，确保数据不为空
  3. **Mapper 层**：SQL 中 `subject_name` 字段必填
- **相关文件**：
  - `RuoYi-Vue-redis/ry-news-system/src/main/resources/mapper/study/StudySubjectMapper.xml` - 已修改，`subject_name` 字段必填
  - `RuoYi-Vue-redis/ry-news-system/src/main/java/com/ddnai/system/service/impl/study/StudySubjectServiceImpl.java` - 已添加验证逻辑
  - `RuoYi-Vue-redis/ry-news-system/src/main/java/com/ddnai/system/domain/study/StudySubject.java` - 已添加验证注解
  - `RuoYi-Vue-redis/ruoyi-ui/src/views/study/subject/index.vue` - 已修复字段名匹配问题
- **状态**：✅ 已解决

### 问题补充说明
**重要提示**：如果修改后仍然报错，可能是以下原因：
1. **后端未重新编译**：需要重新编译后端项目，确保 `target/classes` 目录下的文件已更新
   ```bash
   mvn clean compile
   # 或
   mvn clean package
   ```
2. **前端未刷新**：清除浏览器缓存或强制刷新页面（Ctrl+F5）
3. **服务未重启**：修改后端代码后需要重启 Spring Boot 服务

### 问题总结
通过三层验证机制（Controller、Service、Mapper），确保 `subject_name` 字段在插入数据库前已经过验证，避免数据库层面的错误。这样可以在更早的阶段发现问题，提供更好的错误提示。

---

### 问题2
- **关联步骤**：[[第三阶段-核心功能完善和UniApp开发]]
- **问题描述**：
  1. 视频上传时，选择MP4格式不支持
  2. 选择科目时显示的是ID而不是科目名称
- **发生时间**：2025-11-11
- **问题原因**：
  1. **视频格式不支持**：
     - `FileUpload` 组件默认的 `fileType` 只包含文档格式，不包含视频格式
     - 课件上传页面没有根据课件类型动态设置允许的文件类型
     - `el-upload` 组件缺少 `accept` 属性，浏览器文件选择器无法过滤视频文件
  2. **科目显示ID**：
     - 前端代码使用了 `subject.name`，但后端返回的字段是 `subjectName`
     - 导致下拉框显示为 `undefined` 或ID值
- **解决方案**：
  1. **修复视频上传**：
     - 在 `courseware/index.vue` 中，根据课件类型动态设置 `fileType` 和 `fileSize`
     - 视频类型：允许 `['mp4', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'webm']`，大小限制500MB
     - 图文类型：允许文档和图片格式，大小限制50MB
     - 在 `FileUpload` 组件中添加 `accept` 属性，根据 `fileType` 动态生成MIME类型
  2. **修复科目显示**：
     - 在 `courseware/index.vue` 和 `course/index.vue` 中，将 `:label="subject.name"` 改为 `:label="subject.subjectName"`
- **相关文件**：
  - `RuoYi-Vue-redis/ruoyi-ui/src/views/study/courseware/index.vue` - 已修复文件类型和科目显示
  - `RuoYi-Vue-redis/ruoyi-ui/src/views/study/course/index.vue` - 已修复科目显示
  - `RuoYi-Vue-redis/ruoyi-ui/src/components/FileUpload/index.vue` - 已添加accept属性支持
- **状态**：✅ 已解决

---

### 问题3
- **关联步骤**：[[第三阶段-核心功能完善和UniApp开发]]
- **问题描述**：
  1. 课件上传后文件大小显示为0
  2. 课件上传后无法查看（视频和文档都需要查看功能）
- **发生时间**：2025-11-11
- **问题原因**：
  1. **文件大小显示为0**：
     - 文件上传接口 `/common/upload` 返回的数据中没有包含文件大小（`fileSize`）
     - `FileUpload` 组件上传成功后，只保存了 `fileName` 和 `url`，没有保存文件大小
     - 课件添加时，没有从上传结果中获取文件大小并保存到数据库
  2. **无法查看课件**：
     - 课件列表页面只有"修改"和"删除"按钮，没有"查看"按钮
     - 没有实现课件预览功能（视频、PDF、图片、文档等）
- **解决方案**：
  1. **修复文件大小保存**：
     - 修改 `CommonController.uploadFile` 方法，在返回结果中添加 `fileSize` 字段
     - 修改 `FileUpload` 组件，在上传成功后保存文件大小，并通过 `file-info` 事件传递给父组件
     - 修改课件添加逻辑，监听 `file-info` 事件，从上传结果中获取文件大小并设置到 `form.fileSize`
  2. **添加课件查看功能**：
     - 在课件列表的操作列中添加"查看"按钮
     - 创建课件查看对话框，支持：
       - **视频**：使用 `<video>` 标签播放
       - **PDF**：使用 `<iframe>` 标签预览
       - **图片**：使用 `el-image` 组件预览（支持放大）
       - **其他文档**：显示下载按钮
     - 在编辑对话框中也添加"查看文件"按钮
     - 显示文件信息（文件名、大小、描述）
- **相关文件**：
  - `RuoYi-Vue-redis/ry-news-admin/src/main/java/com/ddnai/web/controller/common/CommonController.java` - 已添加文件大小返回
  - `RuoYi-Vue-redis/ruoyi-ui/src/components/FileUpload/index.vue` - 已添加文件大小保存和事件触发
  - `RuoYi-Vue-redis/ruoyi-ui/src/views/study/courseware/index.vue` - 已添加文件大小处理和查看功能
- **状态**：✅ 已解决