agentscope-ai/agentscope-java

[Bug]:1.0.11 AgentScopeJvmShutdownHook conflict with spring

Open

#1,093 opened on Apr 1, 2026

View on GitHub
 (5 comments) (1 reaction) (1 assignee)Java (693 forks)user submission
area/core/memorybuggood first issue

Repository metrics

Stars
 (3,253 stars)
PR merge metrics
 (Avg merge 3d 15h) (40 merged PRs in 30d)

Description

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并发冲突。

Contributor guide

Research direction
Investigate how AgentScope registers its JVM shutdown hook and explore options to disable it when running in a Spring application context, or to delegate shutdown to Spring's lifecycle manager.
Tech stack
javaspring
Domain
backend
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
JavaSpring
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50