提交代码
This commit is contained in:
1 parent
2a38245ae2
commit
2d63693111
38 files changed
+5489
-1372
No files matched your search
@@ -4381,6 +4381,8 @@ CREATE TABLE `xg_dorm_hygiene_check` (
|
||||
`attachment_ids` text COMMENT '附件OSS ID列表,逗号分隔',
|
||||
`check_summary` text COMMENT '检查总结',
|
||||
`improvement_suggestions` text COMMENT '整改建议',
|
||||
`discipline_type_id` bigint(20) DEFAULT NULL COMMENT '违纪类型ID,关联xskh_discipline_type.id',
|
||||
`discipline_type_name` varchar(100) DEFAULT NULL COMMENT '违纪类型名称',
|
||||
`check_remarks` varchar(500) DEFAULT NULL COMMENT '检查备注',
|
||||
PRIMARY KEY (`id`) USING BTREE,
|
||||
KEY `idx_tenant_id` (`tenant_id`),
|
||||
@@ -4394,6 +4396,7 @@ CREATE TABLE `xg_dorm_hygiene_check` (
|
||||
KEY `idx_hygiene_grade` (`hygiene_grade`),
|
||||
KEY `idx_check_type` (`check_type`),
|
||||
KEY `idx_create_time` (`create_time`),
|
||||
KEY `idx_discipline_type_id` (`discipline_type_id`),
|
||||
KEY `idx_tenant_deleted` (`tenant_id`,`deleted`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='宿舍卫生检查表';
|
||||
|
||||
|
||||
@@ -12,6 +12,9 @@ CREATE TABLE `xskh_discipline_type` (
|
||||
`type_name` varchar(100) NOT NULL COMMENT '类型名称',
|
||||
`type_category` char(1) NOT NULL COMMENT '类型分类(1-违纪类型 2-处分类型)',
|
||||
`remark` varchar(500) DEFAULT NULL COMMENT '类型说明',
|
||||
`area_type` char(1) DEFAULT '1' COMMENT '区域类型(1-宿舍区违纪 2-教学区违纪)' ,
|
||||
`min_score` decimal(5,2) DEFAULT 0.00 COMMENT '最低扣分',
|
||||
`max_score` decimal(5,2) DEFAULT 100.00 COMMENT '最高扣分',
|
||||
`status` char(1) DEFAULT '0' COMMENT '状态(0-正常 1-停用)',
|
||||
`sort_order` int(4) DEFAULT 0 COMMENT '排序号',
|
||||
`create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
|
||||
@@ -27,6 +30,39 @@ CREATE TABLE `xskh_discipline_type` (
|
||||
KEY `idx_status` (`status`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='学生违纪处分类型表';
|
||||
|
||||
-- 1. 宿舍卫生检查违纪关联表(关联宿舍检查与违纪记录)
|
||||
DROP TABLE IF EXISTS `xg_hygiene_check_violation`;
|
||||
CREATE TABLE `xg_hygiene_check_violation` (
|
||||
`id` bigint(20) NOT NULL COMMENT '主键ID',
|
||||
`tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
|
||||
`hygiene_check_id` bigint(20) NOT NULL COMMENT '宿舍卫生检查ID,关联xg_dorm_hygiene_check.id',
|
||||
`discipline_record_id` bigint(20) NOT NULL COMMENT '违纪记录ID,关联xskh_discipline_record.id',
|
||||
`student_id` bigint(20) NOT NULL COMMENT '学生ID,关联xg_student_msg.id',
|
||||
`student_no` varchar(20) NOT NULL COMMENT '学号',
|
||||
`student_name` varchar(50) NOT NULL COMMENT '学生姓名',
|
||||
`discipline_type_id` bigint(20) NOT NULL COMMENT '违纪类型ID,关联xskh_discipline_type.id',
|
||||
`discipline_type_name` varchar(100) NOT NULL COMMENT '违纪类型名称',
|
||||
`violation_source` char(1) DEFAULT '1' COMMENT '违纪来源(1宿舍卫生检查 2其他)',
|
||||
`status` char(1) DEFAULT '1' COMMENT '状态(1生效 2已撤销)',
|
||||
`create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
|
||||
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
|
||||
`update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
|
||||
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
|
||||
`create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
|
||||
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志(0-未删除 1-已删除)',
|
||||
PRIMARY KEY (`id`) USING BTREE,
|
||||
KEY `idx_tenant_id` (`tenant_id`),
|
||||
KEY `idx_hygiene_check_id` (`hygiene_check_id`),
|
||||
KEY `idx_discipline_record_id` (`discipline_record_id`),
|
||||
KEY `idx_student_id` (`student_id`),
|
||||
KEY `idx_student_no` (`student_no`),
|
||||
KEY `idx_discipline_type_id` (`discipline_type_id`),
|
||||
KEY `idx_violation_source` (`violation_source`),
|
||||
KEY `idx_status` (`status`),
|
||||
KEY `idx_deleted` (`deleted`),
|
||||
KEY `idx_tenant_deleted` (`tenant_id`,`deleted`)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='宿舍卫生检查违纪关联表';
|
||||
|
||||
-- 2. 学生违纪处分记录表
|
||||
DROP TABLE IF EXISTS `xskh_discipline_record`;
|
||||
CREATE TABLE `xskh_discipline_record` (
|
||||
@@ -47,6 +83,7 @@ CREATE TABLE `xskh_discipline_record` (
|
||||
`discipline_content` varchar(500) DEFAULT NULL COMMENT '违纪处分内容',
|
||||
`score_deduction` decimal(5,2) DEFAULT 0.00 COMMENT '扣分分值',
|
||||
`status` char(1) DEFAULT '1' COMMENT '状态(1-生效 2-已撤销)',
|
||||
`violation_source` char(1) DEFAULT '2' COMMENT '违纪来源(1-宿舍卫生检查 2-教学区违纪)',
|
||||
`attachment_oss_ids` varchar(1000) DEFAULT NULL COMMENT '附件OSS文件ID,多个用逗号分隔(申请材料、证明文件等)',
|
||||
`create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
|
||||
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
|
||||
|
||||
@@ -1,211 +0,0 @@
|
||||
# 学生考核指标indicator_type_name字段问题修复
|
||||
|
||||
## 问题描述
|
||||
|
||||
在新增学生考核指标时,出现数据库插入错误:
|
||||
|
||||
```
|
||||
Field 'indicator_type_name' doesn't have a default value
|
||||
```
|
||||
|
||||
## 问题分析
|
||||
|
||||
### 1. 根本原因
|
||||
- 数据库表 `xskh_assessment_indicator` 中的 `indicator_type_name` 字段设置为 `NOT NULL`
|
||||
- 前端传递的数据中只有 `indicatorTypeId`,没有 `indicatorTypeName`
|
||||
- 后端Service层在插入数据时没有自动设置 `indicatorTypeName` 字段的值
|
||||
|
||||
### 2. 字段映射问题
|
||||
- 前端使用 `indicatorDescription` 字段,但后端数据库字段是 `description`
|
||||
- 为了保持前后端代码和数据库字段的一致性,统一使用 `description` 字段名
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. 后端Service层修复
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentIndicatorServiceImpl.java`
|
||||
|
||||
#### 1.1 添加依赖注入
|
||||
```java
|
||||
private final XskhAssessmentIndicatorTypeMapper indicatorTypeMapper;
|
||||
```
|
||||
|
||||
#### 1.2 修改insertByBo方法
|
||||
```java
|
||||
@Override
|
||||
@Transactional(rollbackFor = Exception.class)
|
||||
public Boolean insertByBo(XskhAssessmentIndicatorBo bo) {
|
||||
XskhAssessmentIndicator add = MapstructUtils.convert(bo, XskhAssessmentIndicator.class);
|
||||
|
||||
// 根据指标类型ID设置指标类型名称
|
||||
if (add.getIndicatorTypeId() != null) {
|
||||
XskhAssessmentIndicatorType indicatorType = indicatorTypeMapper.selectById(add.getIndicatorTypeId());
|
||||
if (indicatorType != null) {
|
||||
add.setIndicatorTypeName(indicatorType.getTypeName());
|
||||
}
|
||||
}
|
||||
|
||||
validEntityBeforeSave(add);
|
||||
boolean flag = baseMapper.insert(add) > 0;
|
||||
if (flag) {
|
||||
bo.setId(add.getId());
|
||||
// 保存关联关系
|
||||
saveIndicatorRelations(add.getId(), bo.getDisciplineTypeIds(), bo.getRewardTypeIds());
|
||||
}
|
||||
return flag;
|
||||
}
|
||||
```
|
||||
|
||||
#### 1.3 修改updateByBo方法
|
||||
```java
|
||||
@Override
|
||||
@Transactional(rollbackFor = Exception.class)
|
||||
public Boolean updateByBo(XskhAssessmentIndicatorBo bo) {
|
||||
XskhAssessmentIndicator update = MapstructUtils.convert(bo, XskhAssessmentIndicator.class);
|
||||
|
||||
// 根据指标类型ID设置指标类型名称
|
||||
if (update.getIndicatorTypeId() != null) {
|
||||
XskhAssessmentIndicatorType indicatorType = indicatorTypeMapper.selectById(update.getIndicatorTypeId());
|
||||
if (indicatorType != null) {
|
||||
update.setIndicatorTypeName(indicatorType.getTypeName());
|
||||
}
|
||||
}
|
||||
|
||||
validEntityBeforeSave(update);
|
||||
boolean flag = baseMapper.updateById(update) > 0;
|
||||
if (flag) {
|
||||
// 更新关联关系
|
||||
saveIndicatorRelations(update.getId(), bo.getDisciplineTypeIds(), bo.getRewardTypeIds());
|
||||
}
|
||||
return flag;
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 字段映射修复
|
||||
|
||||
为了保持前后端代码和数据库字段的一致性,统一使用 `description` 字段名:
|
||||
|
||||
#### 2.1 前端类型定义修复
|
||||
**文件**: `web/src/api/xskh/assessmentIndicator/types.ts`
|
||||
|
||||
将所有接口中的 `indicatorDescription` 字段改为 `description`:
|
||||
- `XskhAssessmentIndicatorBo`
|
||||
- `XskhAssessmentIndicatorVo`
|
||||
- `XskhAssessmentIndicatorForm`
|
||||
|
||||
#### 2.2 前端表单修复
|
||||
**文件**: `web/src/views/xskh/assessmentIndicator/AssessmentIndicatorForm.vue`
|
||||
|
||||
- 表单字段名:`indicatorDescription` → `description`
|
||||
- 表单验证规则:`indicatorDescription` → `description`
|
||||
- 初始数据:`indicatorDescription` → `description`
|
||||
|
||||
### 3. Mapper XML修复
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentIndicatorMapper.xml`
|
||||
|
||||
添加缺失的 `createDept` 字段映射:
|
||||
|
||||
```xml
|
||||
<result property="createDept" column="create_dept"/>
|
||||
```
|
||||
|
||||
### 4. 前端CSS修复
|
||||
|
||||
**文件**: `web/src/views/xskh/assessmentIndicator/AssessmentIndicatorForm.vue`
|
||||
|
||||
修复CSS语法错误:
|
||||
|
||||
```css
|
||||
/* 固定多选框高度,防止动态变化 */
|
||||
.fixed-height-select :deep(.el-select__tags) {
|
||||
max-height: 32px;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.fixed-height-select :deep(.el-select__tags-text) {
|
||||
max-width: 120px;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.fixed-height-select :deep(.el-select__collapse-tags) {
|
||||
max-width: 100%;
|
||||
}
|
||||
```
|
||||
|
||||
## 测试验证
|
||||
|
||||
### 1. 创建测试脚本
|
||||
**文件**: `test/学生考核指标API测试脚本.py`
|
||||
|
||||
包含以下测试用例:
|
||||
- 登录认证
|
||||
- 新增学生考核指标
|
||||
- 查询指标列表
|
||||
- 查询指标详情
|
||||
- 修改指标
|
||||
|
||||
### 2. 测试数据
|
||||
```json
|
||||
{
|
||||
"indicatorCode": "zbbm01",
|
||||
"indicatorName": "学生指标01",
|
||||
"description": "学生指标01指标说明",
|
||||
"indicatorTypeId": "1958131304973221889",
|
||||
"maxScore": 2.1,
|
||||
"status": "0",
|
||||
"sortOrder": 0,
|
||||
"disciplineTypeIds": [
|
||||
"1958135628856049666",
|
||||
"1958135753561096193"
|
||||
],
|
||||
"rewardTypeIds": [
|
||||
"1958135350199074817",
|
||||
"1958135400207761409"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 修复效果
|
||||
|
||||
### 1. 问题解决
|
||||
- ✅ 解决了 `indicator_type_name` 字段缺失默认值的问题
|
||||
- ✅ 统一了前后端字段命名,使用 `description` 字段
|
||||
- ✅ 修复了CSS语法错误
|
||||
- ✅ 完善了Mapper XML字段映射
|
||||
|
||||
### 2. 功能增强
|
||||
- ✅ 自动根据指标类型ID设置指标类型名称
|
||||
- ✅ 统一前后端字段命名,提高代码一致性
|
||||
- ✅ 完善了错误处理和日志记录
|
||||
|
||||
### 3. 代码质量
|
||||
- ✅ 遵循项目开发规范
|
||||
- ✅ 添加了完整的注释说明
|
||||
- ✅ 提供了测试脚本验证功能
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **数据库字段约束**: 确保数据库表设计合理,避免不必要的NOT NULL约束
|
||||
2. **字段命名一致性**: 前后端字段名应保持一致,避免不必要的映射转换
|
||||
3. **自动填充**: 对于关联字段,应该在Service层自动填充,而不是依赖前端传递
|
||||
4. **测试验证**: 每次修复后都应该进行完整的测试验证
|
||||
|
||||
## 相关文件
|
||||
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentIndicatorServiceImpl.java`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/bo/XskhAssessmentIndicatorBo.java`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/XskhAssessmentIndicator.java`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentIndicatorVo.java`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentIndicatorMapper.xml`
|
||||
- `web/src/api/xskh/assessmentIndicator/types.ts`
|
||||
- `web/src/views/xskh/assessmentIndicator/AssessmentIndicatorForm.vue`
|
||||
- `test/学生考核指标API测试脚本.py`
|
||||
|
||||
---
|
||||
|
||||
**修复时间**: 2025-01-03
|
||||
**修复人员**: AI Assistant
|
||||
**验证状态**: 待验证
|
||||
@@ -1,162 +0,0 @@
|
||||
# 学生考核指标类型createDept字段问题修复
|
||||
|
||||
## 问题描述
|
||||
|
||||
在 `XskhAssessmentIndicatorTypeController.java` 类的 `add` 方法执行后,数据库中查看数据时发现 `create_dept` 字段(创建人的部门ID)没有插入数据,显示为 NULL。
|
||||
|
||||
## 问题分析
|
||||
|
||||
通过代码分析,发现问题的根本原因是:
|
||||
|
||||
### 1. VO类缺少createDept字段
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentIndicatorTypeVo.java`
|
||||
|
||||
**问题**: VO类中缺少 `createDept` 字段定义,导致字段映射不完整。
|
||||
|
||||
### 2. BO类缺少createDept字段
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/bo/XskhAssessmentIndicatorTypeBo.java`
|
||||
|
||||
**问题**: BO类中缺少 `createDept` 字段定义,影响数据传输。
|
||||
|
||||
### 3. Mapper XML缺少字段映射
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentIndicatorTypeMapper.xml`
|
||||
|
||||
**问题**: resultMap中缺少 `createDept` 字段的映射配置,导致数据库字段无法正确映射到实体属性。
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. 修复VO类
|
||||
在 `XskhAssessmentIndicatorTypeVo.java` 中添加 `createDept` 字段:
|
||||
|
||||
```java
|
||||
/**
|
||||
* 创建部门
|
||||
*/
|
||||
private Long createDept;
|
||||
```
|
||||
|
||||
### 2. 修复BO类
|
||||
在 `XskhAssessmentIndicatorTypeBo.java` 中添加基础字段:
|
||||
|
||||
```java
|
||||
/**
|
||||
* 创建部门
|
||||
*/
|
||||
private Long createDept;
|
||||
|
||||
/**
|
||||
* 创建者
|
||||
*/
|
||||
private Long createBy;
|
||||
|
||||
/**
|
||||
* 创建时间
|
||||
*/
|
||||
private Date createTime;
|
||||
|
||||
/**
|
||||
* 更新者
|
||||
*/
|
||||
private Long updateBy;
|
||||
|
||||
/**
|
||||
* 更新时间
|
||||
*/
|
||||
private Date updateTime;
|
||||
```
|
||||
|
||||
### 3. 修复Mapper XML
|
||||
在 `XskhAssessmentIndicatorTypeMapper.xml` 的两个resultMap中添加字段映射:
|
||||
|
||||
```xml
|
||||
<result property="createDept" column="create_dept"/>
|
||||
```
|
||||
|
||||
### 4. 增强Service实现
|
||||
在 `XskhAssessmentIndicatorTypeServiceImpl.java` 中添加调试日志和手动设置逻辑:
|
||||
|
||||
```java
|
||||
// 调试日志:检查当前登录用户信息
|
||||
try {
|
||||
Long userId = LoginHelper.getUserId();
|
||||
Long deptId = LoginHelper.getDeptId();
|
||||
log.info("🔍 调试信息 - 当前登录用户ID: {}, 部门ID: {}", userId, deptId);
|
||||
|
||||
// 手动设置createDept字段,确保有值
|
||||
if (add.getCreateDept() == null && deptId != null) {
|
||||
add.setCreateDept(deptId);
|
||||
log.info("✅ 手动设置createDept字段: {}", deptId);
|
||||
} else {
|
||||
log.info("⚠️ createDept字段状态: {}", add.getCreateDept());
|
||||
}
|
||||
} catch (Exception e) {
|
||||
log.warn("⚠️ 获取登录用户信息失败: {}", e.getMessage());
|
||||
}
|
||||
```
|
||||
|
||||
## 技术原理
|
||||
|
||||
### MyBatis-Plus字段填充机制
|
||||
系统使用 MyBatis-Plus 的 `@TableField(fill = FieldFill.INSERT)` 注解来自动填充字段:
|
||||
|
||||
```java
|
||||
@TableField(fill = FieldFill.INSERT)
|
||||
private Long createDept;
|
||||
```
|
||||
|
||||
### 字段填充处理器
|
||||
`InjectionMetaObjectHandler` 负责在插入时自动填充字段:
|
||||
|
||||
```java
|
||||
baseEntity.setCreateDept(ObjectUtils.notNull(baseEntity.getCreateDept(), loginUser.getDeptId()));
|
||||
```
|
||||
|
||||
### 字段映射关系
|
||||
- 数据库字段: `create_dept`
|
||||
- 实体属性: `createDept`
|
||||
- 映射配置: `<result property="createDept" column="create_dept"/>`
|
||||
|
||||
## 验证方法
|
||||
|
||||
### 1. 创建测试脚本
|
||||
创建 `test/学生考核指标类型API测试脚本.py` 来验证修复效果。
|
||||
|
||||
### 2. 测试步骤
|
||||
1. 登录系统获取token
|
||||
2. 调用新增API创建测试数据
|
||||
3. 调用查询API检查createDept字段
|
||||
4. 验证字段是否正确填充
|
||||
|
||||
### 3. 预期结果
|
||||
- createDept字段应该包含当前登录用户的部门ID
|
||||
- 不再显示为NULL
|
||||
|
||||
## 预防措施
|
||||
|
||||
### 1. 规范检查
|
||||
- 所有VO类必须包含四个基础字段:`createBy`、`createTime`、`updateBy`、`updateTime`
|
||||
- 新增 `createDept` 字段作为第五个基础字段
|
||||
- Mapper XML必须包含完整的字段映射
|
||||
|
||||
### 2. 代码模板
|
||||
创建标准的代码模板,确保新开发的模块不会遗漏基础字段。
|
||||
|
||||
### 3. 自动化测试
|
||||
建立自动化测试机制,定期检查字段映射的完整性。
|
||||
|
||||
## 相关文件
|
||||
|
||||
### 修改的文件
|
||||
1. `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentIndicatorTypeVo.java`
|
||||
2. `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/bo/XskhAssessmentIndicatorTypeBo.java`
|
||||
3. `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentIndicatorTypeMapper.xml`
|
||||
4. `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentIndicatorTypeServiceImpl.java`
|
||||
|
||||
### 新增的文件
|
||||
1. `test/学生考核指标类型API测试脚本.py`
|
||||
|
||||
## 总结
|
||||
|
||||
通过修复VO类、BO类、Mapper XML的字段映射问题,并增强Service实现的调试功能,成功解决了 `create_dept` 字段不填充的问题。这个问题的根本原因是字段映射不完整,导致MyBatis-Plus的自动填充机制无法正常工作。
|
||||
|
||||
修复后的系统能够正确记录创建人的部门信息,为后续的数据分析和权限控制提供了基础支持。
|
||||
@@ -1,218 +0,0 @@
|
||||
# 学生考核时间格式修复报告
|
||||
|
||||
## 📋 问题描述
|
||||
|
||||
### 问题现象
|
||||
在学生考核管理系统中,点击保存按钮调用接口 `http://localhost/dev-api/assessment/approval/approve` 时,返回的数据中 `bonusApprovalList` 和 `bonusList` 的时间字段显示为不标准的格式:
|
||||
|
||||
```json
|
||||
{
|
||||
"bonusApprovalList": [
|
||||
{
|
||||
"createTime": "2025/8/21 上午10:52",
|
||||
"updateTime": "2025/8/21 上午10:52"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### 问题分析
|
||||
经过代码分析,发现问题出现在以下两个VO类文件中:
|
||||
|
||||
1. **XskhAssessmentBonusApprovalVo.java** - 附加分审核VO类
|
||||
2. **XskhAssessmentSelfScoreVo.java** - 自评得分VO类
|
||||
|
||||
这两个文件中的 `createTime` 和 `updateTime` 字段被错误地定义为 `String` 类型,但使用了 `@JsonFormat` 注解,导致时间格式不正确。
|
||||
|
||||
## 🔧 修复方案
|
||||
|
||||
### 修复文件列表
|
||||
|
||||
#### 1. XskhAssessmentBonusApprovalVo.java
|
||||
**文件路径**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentBonusApprovalVo.java`
|
||||
|
||||
**修复内容**:
|
||||
```java
|
||||
// 修复前
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String updateTime;
|
||||
|
||||
// 修复后
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date updateTime;
|
||||
```
|
||||
|
||||
#### 2. XskhAssessmentSelfScoreVo.java
|
||||
**文件路径**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentSelfScoreVo.java`
|
||||
|
||||
**修复内容**:
|
||||
```java
|
||||
// 修复前
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String updateTime;
|
||||
|
||||
// 修复后
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date updateTime;
|
||||
```
|
||||
|
||||
### 修复原理
|
||||
|
||||
1. **类型一致性**: 将时间字段类型从 `String` 改为 `Date`,与实体类保持一致
|
||||
2. **JSON格式化**: 使用 `@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")` 注解确保时间以标准格式输出
|
||||
3. **遵循项目规范**: 符合项目后端开发规范中关于VO类基础字段的要求
|
||||
|
||||
## 📊 修复效果
|
||||
|
||||
### 修复前
|
||||
```json
|
||||
{
|
||||
"bonusApprovalList": [
|
||||
{
|
||||
"createTime": "2025/8/21 上午10:52",
|
||||
"updateTime": "2025/8/21 上午10:52"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### 修复后
|
||||
```json
|
||||
{
|
||||
"bonusApprovalList": [
|
||||
{
|
||||
"createTime": "2025-08-21 10:52:40",
|
||||
"updateTime": "2025-08-21 10:52:40"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 🧪 验证方法
|
||||
|
||||
### 1. 代码验证
|
||||
- ✅ 检查VO类文件中的时间字段类型
|
||||
- ✅ 确认 `@JsonFormat` 注解正确使用
|
||||
- ✅ 验证字段类型与实体类一致
|
||||
|
||||
### 2. 功能验证
|
||||
创建了验证脚本 `test/学生考核时间格式修复验证.py`,用于:
|
||||
- 登录系统获取token
|
||||
- 调用考核审核接口
|
||||
- 检查返回数据中的时间格式
|
||||
- 验证时间字段是否为标准格式
|
||||
|
||||
### 3. 测试步骤
|
||||
```bash
|
||||
# 1. 启动后端服务
|
||||
cd backend
|
||||
mvn spring-boot:run
|
||||
|
||||
# 2. 运行验证脚本
|
||||
cd test
|
||||
python 学生考核时间格式修复验证.py
|
||||
```
|
||||
|
||||
## 📚 相关规范
|
||||
|
||||
### 项目后端开发规范
|
||||
根据 `.cursor/cursorrules-backend.md` 中的规范:
|
||||
|
||||
#### VO类基础字段规范(强制性)
|
||||
```java
|
||||
/**
|
||||
* 创建者
|
||||
*/
|
||||
private Long createBy;
|
||||
|
||||
/**
|
||||
* 创建时间
|
||||
*/
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date createTime;
|
||||
|
||||
/**
|
||||
* 更新者
|
||||
*/
|
||||
private Long updateBy;
|
||||
|
||||
/**
|
||||
* 更新时间
|
||||
*/
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date updateTime;
|
||||
```
|
||||
|
||||
#### 字段使用注解规范
|
||||
- 时间字段必须使用JSON格式化注解
|
||||
- 字段类型必须统一:createBy/updateBy 为 Long,createTime/updateTime 为 Date
|
||||
- 时间字段必须使用 `@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")` 注解
|
||||
|
||||
## 🔍 预防措施
|
||||
|
||||
### 1. 代码审查
|
||||
- 新增VO类时必须检查基础字段类型
|
||||
- 确保时间字段使用正确的类型和注解
|
||||
|
||||
### 2. 自动化检查
|
||||
- 在CI/CD流程中添加代码规范检查
|
||||
- 使用静态代码分析工具检查字段类型
|
||||
|
||||
### 3. 文档更新
|
||||
- 更新项目开发规范文档
|
||||
- 在团队中推广VO类开发标准
|
||||
|
||||
## 📝 总结
|
||||
|
||||
本次修复解决了学生考核管理系统中时间格式显示不正确的问题,主要修复了:
|
||||
|
||||
1. **2个VO类文件**中的时间字段类型错误
|
||||
2. **4个时间字段**的类型从String改为Date
|
||||
3. **确保JSON格式化注解**正确使用
|
||||
4. **修复Service实现类**中的类型转换错误
|
||||
|
||||
### 🔧 修复详情
|
||||
|
||||
#### 第一阶段:VO类修复
|
||||
- `XskhAssessmentBonusApprovalVo.java` - 修复createTime和updateTime字段类型
|
||||
- `XskhAssessmentSelfScoreVo.java` - 修复createTime和updateTime字段类型
|
||||
|
||||
#### 第二阶段:Service实现类修复(优化方案)
|
||||
- `XskhAssessmentApplicationApprovalServiceImpl.java` - 优化时间字段处理逻辑
|
||||
- **根本解决方案**:修改SQL查询使用ResultMap而不是Map类型
|
||||
- **移除复杂的手动类型转换**:让MyBatis自动处理类型映射
|
||||
- **简化代码**:从50+行手动转换代码简化为1行直接赋值
|
||||
|
||||
### 🚨 编译错误解决
|
||||
|
||||
在修复VO类后,编译时出现了类型转换错误:
|
||||
```
|
||||
不兼容的类型: java.lang.String无法转换为java.util.Date
|
||||
```
|
||||
|
||||
**解决方案**:
|
||||
1. **修改SQL查询**:使用ResultMap替代resultType="java.util.Map"
|
||||
2. **添加ResultMap定义**:`XskhAssessmentSelfScoreWithIndicatorResult`
|
||||
3. **修改Mapper接口**:返回类型从`List<Object>`改为`List<XskhAssessmentSelfScoreVo>`
|
||||
4. **简化Service代码**:移除复杂的手动类型转换,直接使用MyBatis自动映射
|
||||
|
||||
修复后,系统返回的时间格式将符合标准格式 `yyyy-MM-dd HH:mm:ss`,提升了数据的一致性和用户体验。
|
||||
|
||||
---
|
||||
|
||||
**修复人员**: AI Assistant
|
||||
**修复时间**: 2025-01-03
|
||||
**验证状态**: ✅ 已修复
|
||||
**影响范围**: 学生考核管理系统时间显示
|
||||
@@ -1,246 +0,0 @@
|
||||
# 学生考核申请ID精度丢失修复报告
|
||||
|
||||
## 问题描述
|
||||
|
||||
### 错误现象
|
||||
在学生考核申请界面保存时,ID等字段丢失精度,导致存到数据库都为 `1958180338534527000`,后几位都是 `000`。
|
||||
|
||||
### 问题分析
|
||||
1. **根本原因**: JavaScript 大整数精度丢失问题
|
||||
- JavaScript 的 `Number.MAX_SAFE_INTEGER` 为 `9007199254740991`
|
||||
- 雪花ID通常超过这个范围,导致精度丢失
|
||||
- 使用 `parseInt()` 转换大整数字符串时,超出安全范围的数字会被截断
|
||||
|
||||
2. **问题位置**: `safeConvertId` 函数
|
||||
- 原函数使用 `parseInt()` 将字符串ID转换为数字
|
||||
- 对于大整数(如雪花ID),转换后精度丢失
|
||||
|
||||
3. **影响范围**: 所有ID字段
|
||||
- `id`: 主键ID
|
||||
- `studentId`: 学生ID
|
||||
- `collegeId`: 学院ID
|
||||
- `majorId`: 专业ID
|
||||
- `classId`: 班级ID
|
||||
- `scheduleId`: 考核计划ID
|
||||
|
||||
## 修复方案
|
||||
|
||||
### 1. 修复 `safeConvertId` 函数
|
||||
|
||||
**文件**: `web/src/views/xskh/assessmentApplication/AssessmentApplicationForm.vue`
|
||||
|
||||
**修复前**:
|
||||
```typescript
|
||||
const safeConvertId = (id: string | number | undefined): number | undefined => {
|
||||
if (id === undefined || id === null) return undefined;
|
||||
if (typeof id === 'number') return id;
|
||||
if (typeof id === 'string') {
|
||||
// 对于大整数,使用parseInt而不是Number,并检查是否超出安全范围
|
||||
const num = parseInt(id, 10);
|
||||
if (isNaN(num)) return undefined;
|
||||
// 检查是否超出JavaScript安全整数范围
|
||||
if (num > Number.MAX_SAFE_INTEGER) {
|
||||
console.warn('ID超出JavaScript安全整数范围,可能导致精度丢失:', id);
|
||||
}
|
||||
return num;
|
||||
}
|
||||
return undefined;
|
||||
};
|
||||
```
|
||||
|
||||
**修复后**:
|
||||
```typescript
|
||||
const safeConvertId = (id: string | number | undefined): string | undefined => {
|
||||
if (id === undefined || id === null) return undefined;
|
||||
// 始终将ID转换为字符串,避免JavaScript大整数精度丢失
|
||||
return String(id);
|
||||
};
|
||||
```
|
||||
|
||||
### 2. 修复要点
|
||||
|
||||
#### 2.1 类型安全
|
||||
- **返回类型**: 从 `number | undefined` 改为 `string | undefined`
|
||||
- **处理逻辑**: 始终使用 `String()` 转换,保持原始精度
|
||||
- **兼容性**: 后端API支持 `string | number` 类型,无需修改
|
||||
|
||||
#### 2.2 精度保持
|
||||
- **字符串转换**: 使用 `String()` 而不是 `parseInt()`
|
||||
- **精度完整**: 保持雪花ID的完整精度
|
||||
- **无截断**: 避免大整数被截断为 `000`
|
||||
|
||||
#### 2.3 项目一致性
|
||||
- **标准做法**: 与项目中其他模块的处理方式保持一致
|
||||
- **最佳实践**: 参考项目中已有的成功案例
|
||||
|
||||
## 技术原理
|
||||
|
||||
### JavaScript 大整数精度问题
|
||||
|
||||
#### 1. 安全整数范围
|
||||
```javascript
|
||||
Number.MAX_SAFE_INTEGER = 9007199254740991 // 2^53 - 1
|
||||
Number.MIN_SAFE_INTEGER = -9007199254740991 // -(2^53 - 1)
|
||||
```
|
||||
|
||||
#### 2. 雪花ID特点
|
||||
- **长度**: 通常为19位数字
|
||||
- **范围**: 远超JavaScript安全整数范围
|
||||
- **精度**: 需要保持完整精度
|
||||
|
||||
#### 3. 转换对比
|
||||
```javascript
|
||||
// 错误的转换方式(精度丢失)
|
||||
const bigId = "1958180338534527123";
|
||||
const wrongResult = parseInt(bigId); // 1958180338534527000 (精度丢失)
|
||||
|
||||
// 正确的转换方式(保持精度)
|
||||
const correctResult = String(bigId); // "1958180338534527123" (完整精度)
|
||||
```
|
||||
|
||||
### 后端支持
|
||||
|
||||
#### 1. API接口支持
|
||||
```typescript
|
||||
// 所有ID参数都支持 string | number 类型
|
||||
export function getAssessmentApplication(id: string | number) {
|
||||
return request({
|
||||
url: '/assessment/application/' + id,
|
||||
method: 'get'
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 类型定义支持
|
||||
```typescript
|
||||
export interface XskhAssessmentApplicationApprovalBo {
|
||||
id?: string | number;
|
||||
studentId?: string | number;
|
||||
collegeId?: string | number;
|
||||
majorId?: string | number;
|
||||
classId?: string | number;
|
||||
scheduleId?: string | number;
|
||||
// ... 其他字段
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. 后端处理
|
||||
- **Spring Boot**: 自动处理字符串到Long的转换
|
||||
- **MyBatis-Plus**: 支持字符串类型的ID参数
|
||||
- **数据库**: bigint类型可以正确处理字符串输入
|
||||
|
||||
## 验证测试
|
||||
|
||||
### 1. 功能测试
|
||||
|
||||
#### 1.1 新增申请测试
|
||||
- **测试步骤**:
|
||||
1. 打开学生考核申请界面
|
||||
2. 选择考核计划
|
||||
3. 填写申请信息
|
||||
4. 点击保存
|
||||
- **预期结果**: ID字段保持完整精度,数据库记录正确
|
||||
|
||||
#### 1.2 编辑申请测试
|
||||
- **测试步骤**:
|
||||
1. 打开已有申请记录
|
||||
2. 修改申请信息
|
||||
3. 点击保存
|
||||
- **预期结果**: ID字段保持完整精度,更新成功
|
||||
|
||||
#### 1.3 提交申请测试
|
||||
- **测试步骤**:
|
||||
1. 打开申请记录
|
||||
2. 点击提交
|
||||
- **预期结果**: ID字段保持完整精度,提交成功
|
||||
|
||||
### 2. 数据验证
|
||||
|
||||
#### 2.1 前端数据验证
|
||||
```javascript
|
||||
// 验证ID精度
|
||||
const testId = "1958180338534527123";
|
||||
const convertedId = safeConvertId(testId);
|
||||
console.log('转换前:', testId);
|
||||
console.log('转换后:', convertedId);
|
||||
console.log('精度保持:', testId === convertedId); // 应该为 true
|
||||
```
|
||||
|
||||
#### 2.2 后端数据验证
|
||||
```sql
|
||||
-- 查询保存的记录,验证ID精度
|
||||
SELECT id, student_id, college_id, major_id, class_id, schedule_id
|
||||
FROM xskh_assessment_application_approval
|
||||
WHERE id = '1958180338534527123';
|
||||
```
|
||||
|
||||
### 3. 边界测试
|
||||
|
||||
#### 3.1 大整数测试
|
||||
- **测试数据**: 19位雪花ID
|
||||
- **预期结果**: 完整精度保持
|
||||
|
||||
#### 3.2 小整数测试
|
||||
- **测试数据**: 普通整数ID
|
||||
- **预期结果**: 正常转换
|
||||
|
||||
#### 3.3 空值测试
|
||||
- **测试数据**: undefined, null
|
||||
- **预期结果**: 返回 undefined
|
||||
|
||||
## 影响范围
|
||||
|
||||
### 1. 直接影响
|
||||
- ✅ **学生考核申请模块**: 修复完成
|
||||
- ✅ **ID精度保持**: 所有ID字段完整精度
|
||||
- ✅ **数据一致性**: 前后端数据一致
|
||||
|
||||
### 2. 间接影响
|
||||
- ✅ **API接口**: 无需修改,已支持字符串类型
|
||||
- ✅ **数据库**: 无需修改,bigint类型支持字符串输入
|
||||
- ✅ **其他模块**: 无影响
|
||||
|
||||
### 3. 兼容性
|
||||
- ✅ **向后兼容**: 不影响现有功能
|
||||
- ✅ **向前兼容**: 支持新的ID格式
|
||||
- ✅ **跨平台**: 所有平台一致
|
||||
|
||||
## 最佳实践总结
|
||||
|
||||
### 1. 大整数处理原则
|
||||
```typescript
|
||||
// ✅ 正确做法:保持字符串类型
|
||||
const safeConvertId = (id: string | number | undefined): string | undefined => {
|
||||
if (id === undefined || id === null) return undefined;
|
||||
return String(id);
|
||||
};
|
||||
|
||||
// ❌ 错误做法:转换为数字类型
|
||||
const wrongConvertId = (id: string | number | undefined): number | undefined => {
|
||||
return parseInt(String(id), 10); // 可能导致精度丢失
|
||||
};
|
||||
```
|
||||
|
||||
### 2. 项目统一规范
|
||||
- **ID字段**: 始终使用 `string | number` 类型
|
||||
- **转换函数**: 保持字符串格式,避免数字转换
|
||||
- **API接口**: 支持字符串类型参数
|
||||
- **类型定义**: 明确定义支持的类型
|
||||
|
||||
### 3. 测试验证
|
||||
- **功能测试**: 验证保存、编辑、提交功能
|
||||
- **数据验证**: 检查数据库记录精度
|
||||
- **边界测试**: 测试各种ID格式
|
||||
- **兼容性测试**: 确保向后兼容
|
||||
|
||||
## 总结
|
||||
|
||||
通过本次修复,成功解决了学生考核申请界面ID精度丢失的问题:
|
||||
|
||||
1. **问题根除**: 修复了JavaScript大整数精度丢失的根本原因
|
||||
2. **精度保持**: 所有ID字段现在保持完整精度
|
||||
3. **数据一致**: 前后端数据完全一致
|
||||
4. **标准统一**: 与项目其他模块的处理方式保持一致
|
||||
5. **向后兼容**: 不影响现有功能和数据
|
||||
|
||||
修复方案简单有效,符合项目的最佳实践,为后续类似问题提供了标准解决方案。
|
||||
@@ -1,180 +0,0 @@
|
||||
# 学生考核申请LocalDateTime类型转换错误修复报告
|
||||
|
||||
## 问题描述
|
||||
|
||||
**时间**: 2025-01-03
|
||||
**接口**: `GET /assessment/application/student/{studentId}/schedule/{scheduleId}`
|
||||
**错误信息**:
|
||||
```
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "class java.time.LocalDateTime cannot be cast to class java.lang.String (java.time.LocalDateTime and java.lang.String are in module java.base of loader 'bootstrap')",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
## 问题分析
|
||||
|
||||
### 错误原因
|
||||
在 `XskhAssessmentApplicationApprovalServiceImpl.queryById()` 方法中,第83-84行存在类型转换错误:
|
||||
|
||||
```java
|
||||
// 错误的代码
|
||||
selfScoreVo.setCreateTime((String) scoreMap.get("createTime"));
|
||||
selfScoreVo.setUpdateTime((String) scoreMap.get("updateTime"));
|
||||
```
|
||||
|
||||
### 根本原因
|
||||
1. **数据库字段类型**: `create_time` 和 `update_time` 字段在数据库中定义为 `datetime` 类型
|
||||
2. **MyBatis查询返回**: 通过 `selectSelfScoresWithIndicatorInfo` 查询时,MyBatis可能返回 `LocalDateTime` 类型
|
||||
3. **强制类型转换**: 代码中直接强制转换为 `String` 类型,导致 `ClassCastException`
|
||||
|
||||
### 影响范围
|
||||
- 学生考核申请详情查询接口
|
||||
- 学生考核申请表单页面无法正常加载历史数据
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. 修复Service实现类中的类型转换
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentApplicationApprovalServiceImpl.java`
|
||||
|
||||
**修改内容**:
|
||||
```java
|
||||
// 修复前
|
||||
selfScoreVo.setCreateTime((String) scoreMap.get("createTime"));
|
||||
selfScoreVo.setUpdateTime((String) scoreMap.get("updateTime"));
|
||||
|
||||
// 修复后
|
||||
Object createTimeObj = scoreMap.get("createTime");
|
||||
if (createTimeObj != null) {
|
||||
selfScoreVo.setCreateTime(createTimeObj.toString());
|
||||
}
|
||||
Object updateTimeObj = scoreMap.get("updateTime");
|
||||
if (updateTimeObj != null) {
|
||||
selfScoreVo.setUpdateTime(updateTimeObj.toString());
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 添加JSON格式化注解
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentSelfScoreVo.java`
|
||||
|
||||
**修改内容**:
|
||||
```java
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String updateTime;
|
||||
```
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentBonusApprovalVo.java`
|
||||
|
||||
**修改内容**:
|
||||
```java
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private String updateTime;
|
||||
```
|
||||
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentApplicationApprovalVo.java`
|
||||
|
||||
**修改内容**:
|
||||
```java
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date submitTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date teacherApprovalTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date createTime;
|
||||
|
||||
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private Date updateTime;
|
||||
```
|
||||
|
||||
## 修复效果
|
||||
|
||||
### 修复前
|
||||
- 接口返回500错误
|
||||
- 前端无法正常显示考核申请详情
|
||||
- 用户无法查看历史申请记录
|
||||
|
||||
### 修复后
|
||||
- 接口正常返回数据
|
||||
- 前端可以正常显示考核申请详情
|
||||
- 时间字段格式化为标准格式 `yyyy-MM-dd HH:mm:ss`
|
||||
- 支持查看历史申请记录
|
||||
|
||||
## 技术要点
|
||||
|
||||
### 1. 类型安全处理
|
||||
- 使用 `Object` 类型接收查询结果
|
||||
- 通过 `toString()` 方法安全转换
|
||||
- 添加空值检查避免NPE
|
||||
|
||||
### 2. JSON序列化优化
|
||||
- 添加 `@JsonFormat` 注解统一时间格式
|
||||
- 确保前后端时间格式一致
|
||||
- 提升API响应质量
|
||||
|
||||
### 3. 数据库字段映射
|
||||
- 保持与BaseEntity基类的一致性
|
||||
- 遵循项目的时间字段处理规范
|
||||
- 避免类型转换异常
|
||||
|
||||
## 验证方法
|
||||
|
||||
### 1. 接口测试
|
||||
```bash
|
||||
# 测试学生考核申请查询接口
|
||||
GET /assessment/application/student/1/schedule/1958180338534526978
|
||||
```
|
||||
|
||||
### 2. 前端验证
|
||||
- 打开学生考核申请表单页面
|
||||
- 验证历史申请记录正常显示
|
||||
- 检查时间字段格式是否正确
|
||||
|
||||
### 3. 日志检查
|
||||
- 查看后端日志确认无类型转换错误
|
||||
- 验证SQL查询正常执行
|
||||
- 确认数据正确返回
|
||||
|
||||
## 预防措施
|
||||
|
||||
### 1. 代码规范
|
||||
- 避免直接强制类型转换
|
||||
- 使用安全的类型转换方法
|
||||
- 添加适当的空值检查
|
||||
|
||||
### 2. 测试覆盖
|
||||
- 添加单元测试覆盖时间字段处理
|
||||
- 集成测试验证API响应格式
|
||||
- 前端测试确保UI正常显示
|
||||
|
||||
### 3. 文档维护
|
||||
- 更新API文档说明时间字段格式
|
||||
- 记录VO类字段类型定义
|
||||
- 维护问题解决方案文档
|
||||
|
||||
## 总结
|
||||
|
||||
本次修复解决了学生考核申请模块中的LocalDateTime类型转换错误,通过安全的类型处理和JSON格式化注解,确保了接口的稳定性和数据格式的一致性。修复后的代码更加健壮,能够正确处理各种时间类型的数据,提升了用户体验。
|
||||
|
||||
---
|
||||
|
||||
**修复人员**: AI Assistant
|
||||
**修复时间**: 2025-01-03
|
||||
**影响模块**: 学生考核管理模块
|
||||
**测试状态**: 待验证
|
||||
@@ -1,144 +0,0 @@
|
||||
# 学生考核申请更新主键冲突修复报告
|
||||
|
||||
## 问题描述
|
||||
|
||||
### 现象
|
||||
在考核申请表单中,对已有数据进行修改后点击保存按钮,调用PUT接口更新数据时出现主键冲突错误:
|
||||
|
||||
```
|
||||
Duplicate entry '1958434137320771585' for key 'PRIMARY'
|
||||
```
|
||||
|
||||
### 错误详情
|
||||
- **接口**: `PUT /assessment/application`
|
||||
- **错误类型**: `java.sql.SQLIntegrityConstraintViolationException`
|
||||
- **错误位置**: `XskhAssessmentSelfScoreMapper.insert`
|
||||
- **根本原因**: 更新操作误用插入逻辑
|
||||
|
||||
## 问题分析
|
||||
|
||||
### 根本原因
|
||||
在 `XskhAssessmentApplicationApprovalServiceImpl.updateSelfScores()` 和 `updateBonusApprovals()` 方法中,更新逻辑存在严重缺陷:
|
||||
|
||||
**原有错误逻辑**:
|
||||
1. 删除所有关联的子表记录
|
||||
2. 重新插入新的记录
|
||||
|
||||
**问题所在**:
|
||||
- 前端传递的数据包含已存在记录的ID
|
||||
- 后端删除后重新插入时,由于ID已存在导致主键冲突
|
||||
- 这种"删除重建"的方式会丢失原有的创建时间、创建人等审计信息
|
||||
|
||||
### 影响范围
|
||||
- 学生考核自评得分表 (`xskh_assessment_self_score`)
|
||||
- 附加分申请表 (`xskh_assessment_bonus_approval`)
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 修复策略
|
||||
采用"智能更新"策略,根据记录ID是否存在决定执行更新或插入操作:
|
||||
|
||||
```java
|
||||
// 如果ID存在,则更新;否则新增
|
||||
if (selfScore.getId() != null) {
|
||||
// 更新现有记录
|
||||
selfScoreMapper.updateById(selfScore);
|
||||
} else {
|
||||
// 新增记录
|
||||
selfScoreMapper.insert(selfScore);
|
||||
}
|
||||
```
|
||||
|
||||
### 具体修改
|
||||
|
||||
#### 1. 修复自评得分更新逻辑
|
||||
**文件**: `XskhAssessmentApplicationApprovalServiceImpl.java`
|
||||
**方法**: `updateSelfScores()`
|
||||
|
||||
```java
|
||||
private void updateSelfScores(Long applicationId, List<XskhAssessmentSelfScoreBo> selfScoreList) {
|
||||
if (selfScoreList != null && !selfScoreList.isEmpty()) {
|
||||
for (XskhAssessmentSelfScoreBo selfScoreBo : selfScoreList) {
|
||||
XskhAssessmentSelfScore selfScore = MapstructUtils.convert(selfScoreBo, XskhAssessmentSelfScore.class);
|
||||
selfScore.setApplicationId(applicationId);
|
||||
|
||||
// 如果ID存在,则更新;否则新增
|
||||
if (selfScore.getId() != null) {
|
||||
// 更新现有记录
|
||||
selfScoreMapper.updateById(selfScore);
|
||||
} else {
|
||||
// 新增记录
|
||||
selfScoreMapper.insert(selfScore);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 修复附加分申请更新逻辑
|
||||
**文件**: `XskhAssessmentApplicationApprovalServiceImpl.java`
|
||||
**方法**: `updateBonusApprovals()`
|
||||
|
||||
```java
|
||||
private void updateBonusApprovals(Long applicationId, List<XskhAssessmentBonusApprovalBo> bonusApprovalList) {
|
||||
if (bonusApprovalList != null && !bonusApprovalList.isEmpty()) {
|
||||
for (XskhAssessmentBonusApprovalBo bonusApprovalBo : bonusApprovalList) {
|
||||
XskhAssessmentBonusApproval bonusApproval = MapstructUtils.convert(bonusApprovalBo,
|
||||
XskhAssessmentBonusApproval.class);
|
||||
bonusApproval.setApplicationId(applicationId);
|
||||
|
||||
// 如果ID存在,则更新;否则新增
|
||||
if (bonusApproval.getId() != null) {
|
||||
// 更新现有记录
|
||||
bonusApprovalMapper.updateById(bonusApproval);
|
||||
} else {
|
||||
// 新增记录,设置默认状态
|
||||
bonusApproval.setStatus("1"); // 默认待审核状态
|
||||
bonusApprovalMapper.insert(bonusApproval);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 修复效果
|
||||
|
||||
### 优势
|
||||
1. **保留审计信息**: 不再删除重建,保留原有的创建时间、创建人等字段
|
||||
2. **避免主键冲突**: 根据ID存在性智能选择更新或插入操作
|
||||
3. **数据完整性**: 确保数据的连续性和完整性
|
||||
4. **性能优化**: 避免不必要的删除和插入操作
|
||||
|
||||
### 测试验证
|
||||
- ✅ 新增考核申请:正常插入新记录
|
||||
- ✅ 修改考核申请:正常更新现有记录
|
||||
- ✅ 混合操作:同时包含新增和修改的记录
|
||||
- ✅ 数据完整性:审计字段正确保留
|
||||
|
||||
## 经验总结
|
||||
|
||||
### 开发规范
|
||||
1. **更新操作原则**: 避免"删除重建"模式,优先使用"智能更新"
|
||||
2. **ID处理策略**: 根据ID存在性决定操作类型
|
||||
3. **审计字段保护**: 更新时注意保护创建时间、创建人等审计信息
|
||||
4. **事务完整性**: 确保关联数据的更新在同一个事务中
|
||||
|
||||
### 代码审查要点
|
||||
- 检查更新逻辑是否采用"删除重建"模式
|
||||
- 验证是否正确处理已存在记录的ID
|
||||
- 确认审计字段的保留策略
|
||||
- 测试混合操作场景(新增+修改)
|
||||
|
||||
## 相关文件
|
||||
|
||||
- **修复文件**: `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/service/impl/XskhAssessmentApplicationApprovalServiceImpl.java`
|
||||
- **涉及表**:
|
||||
- `xskh_assessment_self_score` (学生考核自评得分表)
|
||||
- `xskh_assessment_bonus_approval` (附加分申请表)
|
||||
- **相关接口**: `PUT /assessment/application`
|
||||
|
||||
---
|
||||
|
||||
**修复时间**: 2025-08-21
|
||||
**修复人员**: AI Assistant
|
||||
**状态**: 已完成
|
||||
@@ -1,153 +0,0 @@
|
||||
# 学生考核自评得分查询字段错误修复报告
|
||||
|
||||
## 问题描述
|
||||
|
||||
**错误时间**: 2025-08-21 11:53:24
|
||||
**错误接口**: `/assessment/approval/1958361581653856257`
|
||||
**错误类型**: SQL语法错误 - 未知字段
|
||||
|
||||
### 错误详情
|
||||
```
|
||||
org.springframework.jdbc.BadSqlGrammarException:
|
||||
Unknown column 'i.indicator_description' in 'field list'
|
||||
```
|
||||
|
||||
### 错误SQL
|
||||
```sql
|
||||
SELECT s.id, s.application_id, s.indicator_id, s.indicator_name,
|
||||
i.indicator_code, i.indicator_description, s.indicator_type,
|
||||
s.max_score, s.self_score, s.self_remark, s.teacher_score,
|
||||
s.teacher_remark, s.create_by, s.create_time, s.update_by, s.update_time
|
||||
FROM xskh_assessment_self_score s
|
||||
LEFT JOIN xskh_assessment_indicator i ON s.indicator_id = i.id AND i.tenant_id = '000000'
|
||||
WHERE s.application_id = ? AND s.deleted = 0 AND s.tenant_id = '000000'
|
||||
ORDER BY s.create_time ASC
|
||||
```
|
||||
|
||||
## 问题分析
|
||||
|
||||
### 根本原因
|
||||
1. **字段名不匹配**: SQL查询中使用了 `i.indicator_description`,但数据库表中实际字段名为 `description`
|
||||
2. **数据库表结构**: `xskh_assessment_indicator` 表中的字段名是 `description`,不是 `indicator_description`
|
||||
|
||||
### 数据库表结构确认
|
||||
```sql
|
||||
-- xskh_assessment_indicator 表结构
|
||||
CREATE TABLE `xskh_assessment_indicator` (
|
||||
`id` bigint(20) NOT NULL COMMENT '主键ID',
|
||||
`indicator_code` varchar(50) NOT NULL COMMENT '指标编码',
|
||||
`indicator_name` varchar(100) NOT NULL COMMENT '指标名称',
|
||||
`indicator_type_id` bigint(20) NOT NULL COMMENT '指标类型ID',
|
||||
`indicator_type_name` varchar(100) NOT NULL COMMENT '指标类型名称',
|
||||
`description` varchar(500) DEFAULT NULL COMMENT '指标说明', -- 正确字段名
|
||||
`max_score` decimal(5,2) NOT NULL COMMENT '最高分值',
|
||||
-- ... 其他字段
|
||||
);
|
||||
```
|
||||
|
||||
## 修复方案
|
||||
|
||||
### 修复文件
|
||||
- **文件路径**: `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentSelfScoreMapper.xml`
|
||||
- **修复方法**: 将SQL查询中的字段名从 `i.indicator_description` 改为 `i.description`
|
||||
|
||||
### 字段命名统一优化
|
||||
为了保持前后端字段命名的一致性,同时进行了以下优化:
|
||||
|
||||
1. **VO类字段统一**: 将 `indicatorDescription` 改为 `description`
|
||||
2. **Mapper映射统一**: 更新ResultMap中的字段映射
|
||||
3. **相关文件同步**: 修改了所有相关的Mapper文件和VO类
|
||||
|
||||
### 具体修复内容
|
||||
|
||||
#### 1. 修复ResultMap映射
|
||||
```xml
|
||||
<!-- 修复前 -->
|
||||
<result property="indicatorDescription" column="indicator_description"/>
|
||||
|
||||
<!-- 修复后 -->
|
||||
<result property="description" column="description"/>
|
||||
```
|
||||
|
||||
#### 2. 修复SQL查询语句
|
||||
```xml
|
||||
<!-- 修复前 -->
|
||||
SELECT
|
||||
s.id, s.application_id, s.indicator_id, s.indicator_name,
|
||||
i.indicator_code, i.indicator_description, s.indicator_type,
|
||||
-- ... 其他字段
|
||||
|
||||
<!-- 修复后 -->
|
||||
SELECT
|
||||
s.id, s.application_id, s.indicator_id, s.indicator_name,
|
||||
i.indicator_code, i.description, s.indicator_type,
|
||||
-- ... 其他字段
|
||||
```
|
||||
|
||||
### 修复后的完整SQL
|
||||
```sql
|
||||
SELECT
|
||||
s.id,
|
||||
s.application_id,
|
||||
s.indicator_id,
|
||||
s.indicator_name,
|
||||
i.indicator_code,
|
||||
i.description, -- 修复:使用正确的字段名
|
||||
s.indicator_type,
|
||||
s.max_score,
|
||||
s.self_score,
|
||||
s.self_remark,
|
||||
s.teacher_score,
|
||||
s.teacher_remark,
|
||||
s.create_by,
|
||||
s.create_time,
|
||||
s.update_by,
|
||||
s.update_time
|
||||
FROM xskh_assessment_self_score s
|
||||
LEFT JOIN xskh_assessment_indicator i ON s.indicator_id = i.id AND i.tenant_id = '000000'
|
||||
WHERE s.application_id = #{applicationId}
|
||||
AND s.deleted = 0
|
||||
AND s.tenant_id = '000000'
|
||||
ORDER BY s.create_time ASC
|
||||
```
|
||||
|
||||
## 验证结果
|
||||
|
||||
### 修复验证
|
||||
1. ✅ **字段映射正确**: ResultMap中的 `description` 字段正确映射到数据库的 `description` 字段
|
||||
2. ✅ **SQL语法正确**: 查询语句使用正确的字段名,符合数据库表结构
|
||||
3. ✅ **VO类兼容**: `XskhAssessmentSelfScoreVo` 类中已正确定义 `description` 字段
|
||||
4. ✅ **字段命名统一**: 前后端字段名保持一致,避免混淆
|
||||
|
||||
### 测试建议
|
||||
1. **接口测试**: 重新调用 `/assessment/approval/{id}` 接口,确认不再出现字段错误
|
||||
2. **数据验证**: 确认返回的指标说明数据正确显示
|
||||
3. **功能测试**: 测试学生考核审核功能,确认自评得分查询正常
|
||||
|
||||
## 经验总结
|
||||
|
||||
### 开发规范提醒
|
||||
1. **字段命名一致性**: SQL查询中的字段名必须与数据库表结构完全一致
|
||||
2. **数据库设计规范**: 遵循项目统一的字段命名规范,避免混淆
|
||||
3. **代码审查**: 在开发过程中注意检查SQL语句的字段名正确性
|
||||
|
||||
### 预防措施
|
||||
1. **数据库文档**: 及时更新数据库设计文档,确保字段名准确
|
||||
2. **代码规范**: 建立SQL编写规范,要求字段名与数据库表结构保持一致
|
||||
3. **测试覆盖**: 增加SQL语法检查的自动化测试
|
||||
|
||||
## 相关文件
|
||||
|
||||
- **数据库设计**: `docs/设计文档/database/学生考核管理/学生考核管理数据库模型.sql`
|
||||
- **Mapper文件**:
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentSelfScoreMapper.xml`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/resources/mapper/xskh/XskhAssessmentPlanMapper.xml`
|
||||
- **VO类**:
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentSelfScoreVo.java`
|
||||
- `backend/ruoyi-modules/ruoyi-xskh/src/main/java/org/dromara/xskh/domain/vo/XskhAssessmentPlanIndicatorVo.java`
|
||||
|
||||
---
|
||||
|
||||
**修复人员**: Cursor AI
|
||||
**修复时间**: 2025-08-21
|
||||
**修复状态**: ✅ 已完成
|
||||
Reference in new issue
Block a user