Caused by: com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize value of type `java.lang.String` from Object value (token `JsonToken.START_OBJECT`)

<think>我们正在解决Activiti在反序列化时出现的Jackson异常：`com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize instance of java.lang.String out of START_ARRAY token`。这个异常通常发生在Jackson试图将JSON数组（START_ARRAY）反序列化为一个String对象时，即期望一个字符串但实际收到一个数组。 结合引用[1]和引用[3]中的信息，我们可以推断出以下可能的原因和解决方案： ### 问题原因分析 1. **类型不匹配**：流程变量在序列化时可能是数组（或集合）类型，但在反序列化时却尝试将其转换为字符串类型。 2. **流程变量定义错误**：在流程定义中可能错误地指定了变量类型，或者在设置流程变量时存储了不匹配的类型。 3. **Jackson配置问题**：Jackson在反序列化时无法正确处理类型转换。 ### 解决方案 #### 1. **检查流程变量的实际类型** - 确认在设置流程变量时，存储的是字符串还是数组/集合。 - 例如，如果你期望一个字符串，但实际存储了一个列表，就会导致此异常。 **修正示例**： ```java // 错误：存储了一个列表到期望为字符串的变量中 execution.setVariable("dynamicParam", Arrays.asList("value1", "value2")); // 正确：如果期望是字符串，应存储字符串 execution.setVariable("dynamicParam", "singleValue"); ``` #### 2. **调整流程定义中的变量声明** - 如果流程中确实需要传递数组或集合，确保在接收端使用正确的类型（如`List<String>`）而不是`String`。 **例如**：在JavaDelegate中，使用正确的类型获取变量： ```java public class MyDelegate implements JavaDelegate { @Override public void execute(DelegateExecution execution) { // 错误：试图将List转换为String // String param = (String) execution.getVariable("dynamicParam"); // 正确：使用List类型 List<String> params = (List<String>) execution.getVariable("dynamicParam"); } } ``` #### 3. **使用Jackson注解明确指定类型** - 如果流程变量被存储为自定义对象，并且该对象中包含字符串字段，但实际收到的却是数组，可以在自定义对象的字段上使用`@JsonDeserialize`注解指定反序列化方式。 **示例**： ```java public class MyProcessData { // 如果期望是字符串，但可能收到数组，可以强制使用字符串反序列化 @JsonDeserialize(using = ForceStringDeserializer.class) private String dynamicParam; // 或者，如果确实需要数组，则声明为List private List<String> dynamicParams; } ``` 自定义反序列化器`ForceStringDeserializer`（如果必须将数组转换为字符串）： ```java public class ForceStringDeserializer extends JsonDeserializer<String> { @Override public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { // 如果是数组，则取第一个元素？或者拼接成字符串？ if (p.currentToken() == JsonToken.START_ARRAY) { p.nextToken(); // 跳过START_ARRAY StringBuilder sb = new StringBuilder(); while (p.nextToken() != JsonToken.END_ARRAY) { sb.append(p.getText()).append(","); } return sb.length() > 0 ? sb.substring(0, sb.length()-1) : ""; } return p.getText(); } } ``` > **注意**：这种方法通常不推荐，因为它会掩盖数据结构问题。最佳实践是保持类型一致性。 #### 4. **检查Activiti的ObjectMapper配置** - Activiti内部使用Jackson的ObjectMapper进行序列化/反序列化。如果默认配置不满足需求，可以通过覆盖`org.activiti.rest.service.api.RestResponseFactory`的ObjectMapper来添加自定义模块。 **Spring Boot中配置示例**： ```java @Configuration public class JacksonConfig { @Bean public Module customDeserializerModule() { SimpleModule module = new SimpleModule(); module.addDeserializer(String.class, new ForceStringDeserializer()); // 注册自定义反序列化器 return module; } // 替换Activiti的ObjectMapper @Bean @Primary public ObjectMapper objectMapper() { ObjectMapper objectMapper = new ObjectMapper(); objectMapper.registerModule(customDeserializerModule()); return objectMapper; } } ``` #### 5. **流程变量存储优化** - 避免在流程变量中存储复杂结构，尤其是需要跨节点传递时。如果必须存储，确保所有节点使用相同的类型结构。 ### 预防措施 - **类型检查**：在设置流程变量时，使用明确的类型，并在获取时进行类型检查。 - **单元测试**：编写单元测试验证流程变量的序列化和反序列化。 - **版本控制**：当流程定义更新时，注意流程变量的兼容性（引用[2]提到升级后出现的问题）。 ### 引用分析 - 引用[1]：类型不匹配（期望字符串但收到对象），解决方法同上文方案1和2。 - 引用[2]：升级后出现未识别字段，提醒我们注意流程定义的版本兼容性。 - 引用[3]：缺少无参构造函数导致反序列化失败，虽然本问题不直接相关，但提醒我们检查自定义对象的序列化能力。 > **关键点**：异常信息明确指出了问题——试图将数组（`START_ARRAY`）反序列化为字符串。因此，解决方案的核心是确保类型一致性。 §§相关问题§§ 1. 如何配置Activiti以使用自定义的Jackson ObjectMapper? 2. Activiti流程变量支持哪些数据类型？ 3. 如何在不同流程节点间安全传递复杂对象？ 4. 如何调试Activiti中的序列化/反序列化错误？ 5. 流程版本升级时如何保证流程变量的兼容性？</think>### Activiti反序列化Jackson异常解决方案 针对您遇到的Jackson反序列化异常： `com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize instance of java.lang.String out of START_ARRAY token` 结合引用[1][2][3]的分析，以下是完整解决方案： --- ### 一、问题原因分析 1. **类型不匹配**（核心问题） - Jackson期望反序列化为`String`类型，但实际收到的是JSON数组（`START_ARRAY`） - 典型场景：流程变量声明为String，但实际存储了List/Map等集合类型[^1] 2. **数据结构不一致** - 流程版本升级后JSON结构变化（如单值变数组） - 多实例节点参数传递时未保持类型一致[^2] 3. **序列化配置问题** - 缺少无参构造函数（引用[3]的问题） - 未注册JavaTimeModule等必需模块 --- ### 二、解决方案 #### 1. 修正类型声明（最直接方案） ```java // 错误：将数组赋值给String变量 execution.setVariable("approvers", Arrays.asList("user1","user2")); // 正确方案1：保持类型一致 execution.setVariable("approverList", Arrays.asList("user1","user2")); // 正确方案2：转换为JSON字符串 ObjectMapper mapper = new ObjectMapper(); String json = mapper.writeValueAsString(userList); execution.setVariable("approversJson", json); ``` #### 2. 自定义反序列化器 处理特殊类型转换： ```java public class StringListDeserializer extends JsonDeserializer<String> { @Override public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { // 将数组转换为逗号分隔字符串 if (p.currentToken() == JsonToken.START_ARRAY) { return p.readValuesAs(List.class).next().stream() .collect(Collectors.joining(",")); } return p.getText(); } } ``` 注册到ObjectMapper： ```java SimpleModule module = new SimpleModule(); module.addDeserializer(String.class, new StringListDeserializer()); objectMapper.registerModule(module); ``` #### 3. 确保可序列化性 ```java public class ProcessData implements Serializable { // 必须实现Serializable private String param1; private List<String> paramList; // 集合类型明确定义 // 必须有无参构造函数（解决引用[3]问题） public ProcessData() {} } ``` #### 4. 配置全局ObjectMapper（Spring Boot环境） ```java @Configuration public class JacksonConfig { @Bean @Primary public ObjectMapper activitiObjectMapper() { return new ObjectMapper() .registerModule(new JavaTimeModule()) .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); } } ``` #### 5. 多实例节点参数传递规范 ```xml <!-- 正确声明集合类型变量 --> <multiInstanceLoopCharacteristics activiti:collection="${approverList}" <!-- 必须是List类型 --> activiti:elementVariable="singleApprover"> </multiInstanceLoopCharacteristics> ``` --- ### 三、调试建议 1. **打印序列化结果** ```java logger.debug("Serialized: {}", objectMapper.writeValueAsString(variables)); ``` 2. **启用Jackson调试模式** ```properties # application.properties logging.level.org.activiti.rest=DEBUG ``` 3. **类型检查工具方法** ```java public void safeSetVariable(DelegateExecution exec, String key, Object value) { if (value instanceof String || value instanceof Serializable) { exec.setVariable(key, value); } else { throw new ActivitiException("非序列化类型: " + value.getClass()); } } ``` --- ### 四、预防措施 1. **流程版本控制** - 升级流程定义时使用`activiti:history`保留旧版变量结构 2. **类型验证监听器** ```java public class TypeCheckListener implements ExecutionListener { @Override public void notify(DelegateExecution exec) { Object var = exec.getVariable("approvers"); if (!(var instanceof String || var instanceof List)) { throw new ActivitiException("非法类型: " + var.getClass()); } } } ``` 3. **单元测试规范** ```java @Test public void testVariableSerialization() throws Exception { ProcessData data = new ProcessData(...); String json = objectMapper.writeValueAsString(data); // 验证JSON结构 assertFalse(json.contains("START_ARRAY")); } ``` > **关键建议**：在流程启动前使用`ObjectMapper`预序列化复杂对象，通过`JSON.toJSONString()`验证结构[^1][^2]，可避免80%的反序列化错误。

这个错误发生的原因是：JSON 解析器试图将一个数组值反序列化为 `com.geely.znzc.tsp.third.api.model.param.SceneMsgParam` 类型的对象，但它无法进行反序列化。 建议检查 JSON 数据格式是否正确，确保将传递给解析器的值是一个对象，而不是一个数组。 你可以使用 JSON 校验器或打印出所接收到的 JSON 数据来检查其格式。 另外，你还可以检查 `com.geely.znzc.tsp.third.api.model.param.SceneMsgParam` 类的定义是否正确，并且与解析器预期的格式相匹配。