### 兼容说明

兼容问题：

* 插件 solon-flow 第四次预览，接口有微调（[文档已调整](/article/learn-solon-flow)）
* 插件 solon-flow stateful 第三次预览，接口有变动（[文档已调整](/article/1106)）


提醒：

* 插件 solon-ai-mcp 协议升为 MCP_2025-03-26（支持 streamable、annotation、outputSchema 等特性）
* 插件 solon-ai-mcp channel 取消默认值（之前为 sse。[文档已调整](/article/learn-solon-ai-mcp)），且为必填。升级后，要补一下这个配置
* 最近还新增了 [solon-statemachine 插件](/article/1125)（欢迎试用）

建议：

* 使用 `solon-server-*` 插件替代 `solon-boot-*`（原先的 boot 是 server 启动的意思，很多人误会把 solon-boot 与 springboot 对应起来。现标为弃用）
* 相对的：solon 与 springboot 对标；solon cloud 与 spring cloud 对标；solon ai 与 spring ai 对标


### 具体更新


* 新增 solon-ai-mcp MCP_2025-03-26 版本协议支持
* 插件 solon-flow 第四次预览
* 插件 solon-flow stateful 第三次预览
* 添加 solon-flow FlowDriver:postHandleTask 方法
* 优化 solon-net-httputils HttpUtils 与 HttpUtilsFactory（部分功能迁到 HttpUtils） 关系简化
* 优化 solon-net-httputils OkHttpUtils 适配与 tlsv1 的兼容性
* 优化 solon-net-httputils JdkHttpResponse:bodyAsString 的编码处理（没有 ContentEncoding 时，优先用 charset 配置）
* 优化 solon-expression SnelEvaluateParser:parseNumber 增强识别 "4.56e-3"（科学表示法）和 "1-3"（算数）
* 优化 solon 启动后 Lifecycle:postStart 可在加入时直接执行
* 调整 solon-flow FlowContext 拆分为：FlowContext（对外） 和 FlowExchanger（对内）
* 调整 solon-flow FlowContext 移除 result 字段（所有数据基于 model 交换）
* 调整 solon-flow FlowContext get 改为返回 Object（之前为 T），新增 getAs 返回 T（解决 get 不能直接打印的问题）
* 调整 solon-flow 移除 StatefulSimpleFlowDriver 功能合并到 SimpleFlowDriver（简化）
* 调整 solon-flow 新增 stateless 包，明确有状态与无状态这两个概念（StatelessFlowContext 更名为 StatefulFlowContext）
* 调整 solon-flow FlowStatefulService 接口，每个方法的 context 参数移到最后位（保持一致性）
* 调整 solon-flow 新增 StatefulSupporter 接口，方便 FlowContext 完整的状态控制
* 调整 solon-flow StateRepository 接口的方法命名，与 StatefulSupporter 保持一致性
* 调整 solon-flow Chain 拆分为：Chain 和 ChainDecl。Chain 为运行态（不可修改）；ChainDecl 为配置态（可以随时修改）。
* 调整 `solon-boot-*` 插件（标为弃用） 更名为 `solon-server-*` 
* 调整 `solon.boot` 包名（相关工具标为弃用） 更名为 `solon.server`
* 调整 solon-ai-mcp mcp 协议升为 MCP_2025-03-26（支持 streamable、annotation、outputSchema 等特性）
* 调整 solon-ai-mcp channel 取消默认值（之前为 sse），且为必填（利于协议升级过度，有明确的开发时、启动时提醒）
* 修复 solon-net-httputils OkHttpResponse:contentType 获取错误的问题
* 修复 solon-net-httputils OkHttpUtils 适配重定位后 req-body 数据不能重读的问题
* liquor 升为 1.6.2 （兼容 arm jdk）
* jetty 升为 9.4.58.v20250814