85 lines
4.1 KiB
Markdown
85 lines
4.1 KiB
Markdown
# Bug #741 诸葛亮分析报告
|
||
|
||
> **文档类型**: Bug分析
|
||
> **分析时间**: 2026-06-12 11:46:17
|
||
> **分析模型**: mimo-v2.5 (LLM深度分析)
|
||
|
||
---
|
||
|
||
## 基本信息
|
||
- **Bug #**: 741
|
||
- **标题**: 【住院医生工作站】打开门诊医生工作站会有代码列表报错
|
||
- **模块**: 住院医生工作站
|
||
- **提出人**: 王栩坤
|
||
|
||
---
|
||
|
||
### 一、Bug 理解
|
||
|
||
用户登录 doctor1 账号进入**住院医生工作站**页面时，页面加载过程中某个 API 请求返回了 500 错误，错误信息为 `class java.util.ArrayList cannot be cast to class com.fasterxml.jackson.databind.JsonNode`。这个 Java ClassCastException 被前端 `request.js` 拦截器捕获并弹出错误提示，导致页面功能异常。期望是页面能正常加载，患者列表和各 Tab 页正常工作。
|
||
|
||
### 二、根因分析
|
||
|
||
**直接原因**：后端某个 API 接口在处理请求或序列化响应时，抛出了 `ClassCastException: ArrayList cannot be cast to JsonNode`。异常被 `GlobalExceptionHandler` 捕获后返回 `{code:500, msg:"class java.util.ArrayList cannot be cast to class com.fasterxml.jackson.databind.JsonNode"}`。
|
||
|
||
**根因定位**：commit `68cfa4882` 修改了 `ApplicationConfig`，将 `Jackson2ObjectMapperBuilderCustomizer` 替换为直接创建 `new ObjectMapper()` 的 `@Bean`。
|
||
|
||
```java
|
||
// 旧代码 — 定制 Spring Boot 自动配置的 ObjectMapper
|
||
@Bean
|
||
public Jackson2ObjectMapperBuilderCustomizer jacksonObjectMapperCustomization() {
|
||
return builder -> { ... };
|
||
}
|
||
|
||
// 新代码 — 直接覆盖 Spring Boot 自动配置的 ObjectMapper
|
||
@Bean
|
||
public ObjectMapper objectMapper() {
|
||
ObjectMapper mapper = new ObjectMapper();
|
||
...
|
||
}
|
||
```
|
||
|
||
**问题机制**：
|
||
1. 定义 `@Bean ObjectMapper` 会**替换** Spring Boot 自动配置的 `ObjectMapper`，丢失大量自动配置（模块注册、类型解析器、序列化注解处理等）
|
||
2. Spring Boot 4.x 的 `MappingJackson2HttpMessageConverter` 使用此 Bean 做响应序列化
|
||
3. 当 `DictAspect`（拦截所有 `@GetMapping`/`@PostMapping`）处理 `R<IPage<RegPatientMainInfoDto>>` 响应时，`IPage` 的泛型信息在新 `ObjectMapper` 下无法正确解析
|
||
4. Jackson 内部在序列化过程中尝试将 `ArrayList`（`IPage` 内部的 records 列表）强转为 `JsonNode`，导致 `ClassCastException`
|
||
|
||
**涉及文件**：
|
||
- `core-framework/.../ApplicationConfig.java` — **根因所在**，ObjectMapper Bean 配置不当
|
||
- `healthlink-his-common/.../DictAspect.java` — 拦截所有 Controller 方法，触发序列化链路
|
||
- `regdoctorstation/.../AdviceManageController.java` — `/reg-patient-zk` 端点
|
||
- `regdoctorstation/.../AdviceManageAppServiceImpl.java` — `getRegPatientMainInfo()` 返回 `IPage`
|
||
- `utils/request.js` — 前端拦截器，line 186 抛出 Promise reject
|
||
|
||
### 三、修复方案
|
||
|
||
**修改文件**：`core-framework/src/main/java/com/core/framework/config/ApplicationConfig.java`
|
||
|
||
**修复方式**：将 `@Bean ObjectMapper` 回退为 `Jackson2ObjectMapperBuilderCustomizer`，这样 Spring Boot 自动配置的 ObjectMapper 保持不变，只在其基础上追加自定义配置：
|
||
|
||
```java
|
||
@Bean
|
||
public Jackson2ObjectMapperBuilderCustomizer jacksonObjectMapperCustomization() {
|
||
return builder -> {
|
||
builder.timeZone(TimeZone.getDefault());
|
||
builder.simpleDateFormat("yyyy-MM-dd HH:mm:ss");
|
||
JavaTimeModule javaTimeModule = new JavaTimeModule();
|
||
javaTimeModule.addDeserializer(LocalDateTime.class, LOCAL_DATE_TIME_DESERIALIZER);
|
||
javaTimeModule.addSerializer(LocalDateTime.class,
|
||
new LocalDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
|
||
builder.modules(javaTimeModule);
|
||
};
|
||
}
|
||
```
|
||
|
||
**验证步骤**：
|
||
1. `mvn clean compile -DskipTests` — 编译通过
|
||
2. 启动应用 → 以 doctor1 登录 → 进入住院医生工作站 → 确认无报错
|
||
3. 验证患者列表正常加载、诊断/医嘱 Tab 页正常切换
|
||
|
||
### 四、路由决策
|
||
|
||
- **修复 Agent**: guanyu（后端开发）
|
||
- **原因**: 修复点在 `ApplicationConfig.java` 的 ObjectMapper Bean 配置，属于后端 Spring 配置问题，需要回退 Jackson 序列化配置并验证编译通过。
|