agentscope-ai/agentscope-java

[Bug]:1.0.11 AgentScopeJvmShutdownHook conflict with spring

Open

#1.093 geöffnet am 1. Apr. 2026

Auf GitHub ansehen
 (5 Kommentare) (1 Reaktion) (1 zugewiesene Person)Java (3.253 Stars) (693 Forks)user submission
buggood first issue

Beschreibung

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

Tech Stack
javaspring
Domain
backend
Issue Type
bug
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 hours
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
blocked
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
Basic JavaSpring framework basicsJVM shutdown hook concept
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
30
Research-Richtung
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.