Spring State Machine四层状态层级持久化与恢复异常问题

问题确认 #

这是Spring State Machine 4.0.0版本中针对四层及以上状态层级的已知兼容性问题：状态机上下文在Redis持久化/恢复过程中，深层子状态的上下文未被正确序列化/反序列化，导致恢复后状态机仅识别到三层状态（如[S0, S2, S21]），缺失最底层的S211。进而引发事件不接受（EVENT_NOT_ACCEPTED），以及持久化时因StateMachine.getState()返回null导致的NullPointerException。

可行解决方案 #

1. 版本升级（优先推荐） #

Spring State Machine在4.0.1及后续版本中已修复深层状态层级的持久化逻辑，直接升级到最新稳定版即可解决问题：

// build.gradle.kts 示例
implementation("org.springframework.statemachine:spring-statemachine-core:4.0.3")
implementation("org.springframework.statemachine:spring-statemachine-redis:4.0.3")

2. 自定义Redis上下文序列化逻辑 #

若暂时无法升级版本，可替换默认的Java序列化方式为JSON序列化，确保深层状态上下文被完整保存：

@Component
class RedisPersistenceConfiguration {
    @Bean("redisStateMachinePersist")
    fun redisStateMachinePersist(
        @Qualifier("redisTemplate") redisTemplate: RedisTemplate<String, StateMachineContext<States, Events>>
    ): StateMachinePersist<States, Events, String> {
        val repository = object : RedisStateMachineContextRepository<States, Events>(redisTemplate.connectionFactory) {
            override fun serialize(context: StateMachineContext<States, Events>?): ByteArray {
                return ObjectMapper().writeValueAsBytes(context)
            }

            override fun deserialize(bytes: ByteArray?): StateMachineContext<States, Events>? {
                return bytes?.let { 
                    ObjectMapper().readValue(it, StateMachineContext::class.java) as StateMachineContext<States, Events> 
                }
            }
        }
        return RepositoryStateMachinePersist(repository)
    }

    @Bean("redisTemplate")
    fun redisTemplate(jedisConnectionFactory: JedisConnectionFactory): RedisTemplate<String, StateMachineContext<States, Events>> {
        return RedisTemplate<String, StateMachineContext<States, Events>>().apply {
            keySerializer = StringRedisSerializer()
            valueSerializer = Jackson2JsonRedisSerializer(StateMachineContext::class.java)
            setConnectionFactory(jedisConnectionFactory)
            afterPropertiesSet()
        }
    }
}

注意：需添加Jackson相关依赖，确保能正确序列化StateMachineContext及其嵌套类。

3. 临时规避：调整状态层级结构 #

将四层状态合并为三层（比如将S211的逻辑整合到S21的子状态判断中，或重新划分状态结构），绕过深层状态的持久化缺陷。

4. 修复持久化时的NPE问题 #

在当前代码中添加状态检查，避免stateMachine.getState()为null时触发异常：

// Controller中修改持久化逻辑
if (machine.state != null) {
    persister.persist(machine, stateMachineId)
} else {
    log.error("State machine state is null, skip persist for id: {}", stateMachineId)
    // 可选：重新加载上下文或触发状态恢复逻辑
}

根源分析 #

Spring State Machine 4.0.0默认的Java序列化逻辑在处理多层嵌套状态时，未完整保存子状态的上下文元数据，导致恢复过程中仅能加载到第三层状态。后续版本通过优化上下文序列化的递归处理逻辑，修复了该问题。

内容的提问来源于stack exchange，提问作者alexshv