his/MD/bugs/BUG_741_ANALYSIS.md

# 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 序列化配置并验证编译通过。