agentscope-ai/agentscope-java

[Bug]:1.0.11 AgentScopeJvmShutdownHook conflict with spring

Open

#1,093 opened on 2026年4月1日

GitHub で見る
 (5 comments) (1 reaction) (1 assignee)Java (3,253 stars) (693 forks)user submission
buggood first issue

説明

spring工程的SIGTERM信号响应是由spring的ShutdownHook处理的，agentscope又注册了一个AgentScopeJvmShutdownHook。这两个hook之间是并行的，会造成spring容器没有完全关闭时会正常接受请求，但是agent已经关闭了，调用会报错返回Operation interrupted due to system shutting down, please retry。 按照我的理解，在spring工程中agentscope不需要这种hook，生命周期是由spring统一管理。 之前dubbo也有这种问题，提供了一个ShutdownHook和spring的ShutdownHook并发冲突。

コントリビューターガイド

技術スタック
javaspring
領域
backend
Issue 種別
bug
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
3
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-3 hours
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
blocked
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Basic JavaSpring framework basicsJVM shutdown hook concept
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
30
調査方針
Investigate AgentScope's registration of AgentScopeJvmShutdownHook and Spring's default shutdown hook. Understand the conflict: during SIGTERM, both hooks run in parallel, causing Spring context not fully closed while agent is already shut down. Look for similar issues in Dubbo that led to a solution. Consider making AgentScope's hook optional or compatible with Spring's lifecycle. Check if there is a Spring specific configuration to disable the custom hook.
[Bug]:1.0.11 AgentScopeJvmShutdownHook conflict with spring · agentscope-ai/agentscope-java#1093 | Good First Issue