8 个 Java 工作线程同时看到会话空闲时,Spring AI 2.1.0-RC2 的普通追加留下 8 条认领事件,带版本追加只留下 1 条。这个结果在内存仓库和 Spring Boot 自动配置的 H2 JDBC 仓库中一致。把 Agent 的会话归属放进事件日志时,认领写入需要携带读状态之前取得的版本,并在冲突后重新读取状态。

场景是两个以上的 Agent 工作线程接到同一个 sessionId,都准备接手下一段任务。先查询“还没人接手”,再追加 owner,中间留着一个竞争窗口。事件日志允许保存多条认领记录,线程安全的追加操作本身不会判定哪个 Agent 有权接手。

11 月 11 日 22:06:39(Asia/Shanghai)合并的 Spring AI #7372 补充了会话扩展文档和并发追加契约测试。下面使用的是 11 月 6 日 00:06:25(Asia/Shanghai)发布的 2.1.0-RC2 工件,验证已有的版本追加 API;未使用该 PR 新开放的 SessionContexts,也未把它计入 RC2。RC2 是候选版本,尚非 GA。

先把“认领”限定成一条应用协议

实验创建全新的会话,以自定义事件类型 ACME.CLAIM 保存 owner。没有 CLAIM 代表空闲,出现 CLAIM 代表已认领;不包含释放、租约到期和强制接管。这是实验定义的 Agent 归属协议,框架提供的是日志和版本检查。

static final EventType CLAIM = EventType.of("ACME.CLAIM");

static SessionEvent claim(String id, String owner) {
    return SessionEvent.builder().sessionId(id).type(CLAIM).payload("owner", owner).build();
}

static List<SessionEvent> claims(SessionService s, String id) {
    return s.getEvents(id).stream().filter(e -> e.getType().equals(CLAIM)).toList();
}

这里从完整日志筛选认领事件。此前的压缩窗口不拆工具轮讨论了消息怎样进入上下文;这次只检查日志里的归属记录,不读取模型上下文视图。

同一版本的八次追加,只成功一次

项目使用 Temurin 21.0.13、Maven 3.9.11、Spring Boot 4.0.5、Spring AI 2.1.0-RC2、H2 2.4.240 和 JUnit Jupiter 6.0.3。JDBC 由下面的 starter 自动配置,另有 H2 运行时依赖和 Boot 测试 starter;内存对照组使用 InMemorySessionRepository.builder().build()。

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-session-jdbc</artifactId>
    <version>2.1.0-RC2</version>
</dependency>

JUnit 启动无 Web 服务的 Boot 测试上下文,自动初始化 H2 表。实际数据源隔离级别经过断言,启动记录如下:

BOOT service=org.springframework.ai.session.DefaultSessionService repository=org.springframework.ai.session.jdbc.JdbcSessionRepository database=H2 databaseVersion=2.4.240 (2025-09-22) isolation=READ_COMMITTED

每个并发对照用例先创建空会话,再启动 8 个线程。每个线程先读版本,再读 CLAIM,随后在八方 CyclicBarrier 等齐;断言确认 8 个线程读到的版本都是 0,认领列表都为空。工作线程的已执行代码节选如下,checked 控制两条对照路径:

long version = s.getEventVersion(id);
boolean free = claims(s, id).isEmpty();
bothRead.await(10, TimeUnit.SECONDS);
boolean accepted = false;
if (free) {
    SessionEvent event = claim(id, owner);
    if (checked) accepted = s.appendEvents(id, List.of(event), version);
    else { s.appendEvent(event); accepted = true; }
}

checked=false 使用普通追加,8 个不同 owner 都写入成功。checked=true 把读到的版本交给 appendEvents,只有一个线程返回 true,其余 7 个返回 false;日志里只有赢家的 owner,版本从 0 变成 1。两种仓库得到相同结果。

RC2 的 SessionService 契约明确规定:批量追加必须匹配 expectedVersion,失败不写入;先读版本,再读决策依赖的事件。实验没有比较吞吐量,也没有把多个线程当作多个进程。

两条容易混淆的边界

第一条是混用追加方式。实验先用版本 0 成功认领,再让另一条路径直接调用 appendEvent,结果留下 2 条 CLAIM,版本为 2。这组反例顺序执行,说明认领协议必须约束每一条状态写入路径;版本检查不会替普通追加补上 owner 检查。

第二条是把 false 当成“别人已接手”。实验读取版本 0 和空认领列表后,插入一条 ACME.AUDIT 审计事件。携带旧版本的认领返回 false,但此时 CLAIM 仍为 0 条;重新读取版本与状态后,认领成功,最终是 1 条 AUDIT 加 1 条 CLAIM,版本为 2。

这部分的工程判断是:版本冲突表示日志发生了变化,不能直接替代归属判断。固定合并提交中的扩展示例也把“重新读取状态”和“限制重试次数”放在同一个认领循环里。本次执行覆盖了一次无关事件插入后的重新读取与重试,未执行持续冲突下的重试耗尽分支。

八个参数化用例的实际记录

四个场景各跑内存与 JDBC 两种仓库,共 8 个 JUnit 用例。以下是同一次运行中 CASE 行的逐字摘录,保留输出顺序:

CASE store=memory mode=unchecked observedFree=8 accepted=8 claims=8 version=8
CASE store=jdbc mode=unchecked observedFree=8 accepted=8 claims=8 version=8
CASE store=memory mode=unrelated staleAccepted=false claimsBeforeRetry=0 retryAccepted=true claims=1 events=2 version=2
CASE store=jdbc mode=unrelated staleAccepted=false claimsBeforeRetry=0 retryAccepted=true claims=1 events=2 version=2
CASE store=memory mode=mixed checkedAccepted=true uncheckedAppended=true claims=2 version=2
CASE store=jdbc mode=mixed checkedAccepted=true uncheckedAppended=true claims=2 version=2
CASE store=memory mode=checked observedFree=8 accepted=1 rejected=7 claims=1 version=1
CASE store=jdbc mode=checked observedFree=8 accepted=1 rejected=7 claims=1 version=1

执行命令是 mvn -C -B -ntp test。本次运行于 11 月 12 日 08:12:23 至 08:12:28(Asia/Shanghai),独立进程状态记录为 exitStatus=0,Surefire 汇总为:

[INFO] Tests run: 8, Failures: 0, Errors: 0, Skipped: 0

事务与执行范围

上述 JDBC 调用未包在外层事务里,H2 隔离级别为 READ_COMMITTED。RC2 的 JDBC 文档说明,自动配置的仓库会在事务管理器使用同一数据源时参与应用事务;新扩展文档还指出,外层 REPEATABLE_READ 或更高隔离级别会让重试继续读取旧版本,部分数据库的失败写入会抛异常。本次未执行 MySQL、MariaDB、PostgreSQL 或外层事务对照,H2 的记录不作为这些数据库的运行结果。

八个用例实际编译并启动了 Boot 测试上下文,连接了 H2,也调用了真实的内存与 JDBC 仓库。测得的是单进程内的日志追加结果和返回值,未验证重启后的持久性、跨进程认领、持续冲突压测、ChatClient 工具轮或模型调用;没有执行外部业务写入,也不据此声称业务副作用恰好执行一次。

— 感谢阅读 —
广告

一起交流

分享你的思考,让讨论更进一步。