docs(bug): 诸葛亮完整分析报告 Bug #741 (LLM深度分析)

MD/bugs/BUG_741_ANALYSIS.md

@@ -14,12 +14,71 @@
 
 ---
 
-（LLM 失败，关键词分析）
-Bug: 【住院医生工作站】打开门诊医生工作站会有代码列表报错
-模块: 住院医生工作站
+### 一、Bug 理解
 
----
+用户登录 doctor1 账号进入**住院医生工作站**页面时，页面加载过程中某个 API 请求返回了 500 错误，错误信息为 `class java.util.ArrayList cannot be cast to class com.fasterxml.jackson.databind.JsonNode`。这个 Java ClassCastException 被前端 `request.js` 拦截器捕获并弹出错误提示，导致页面功能异常。期望是页面能正常加载，患者列表和各 Tab 页正常工作。
 
-## 路由决策
-- **修复 Agent**: guanyu
-- **原因**: 降级: guanyu
+### 二、根因分析
+
+**直接原因**：后端某个 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 序列化配置并验证编译通过。