Spring Cloud Stream配置shutdownTimeout不生效问题

shutdownTimeout配置不生效是配置遗漏导致的，和你写的ListenerContainerCustomizer代码本身逻辑无关：

• Spring Cloud Stream RabbitMQ Binder默认会对监听容器的参数做默认值填充，如果你没有显式在binder配置中声明shutdownTimeout，自定义器中设置的值会被Binder的默认5秒配置覆盖。
• 未配置Spring Boot上下文的优雅关闭规则：就算Rabbit容器的等待超时设为60秒，如果Spring上下文整体关闭等待时长小于这个值，进程会提前终止，不会等消费逻辑跑完。
• 额外注意：如果你使用的是Spring Cloud Stream 3.0.x及更早版本，ListenerContainerCustomizer的泛型必须精确指定为Rabbit对应的SimpleMessageListenerContainer类型，写父类AbstractMessageListenerContainer会导致自定义器无法被Binder识别。

1. 配置Spring Boot全局优雅关闭规则，在application.yml中添加以下配置，给容器关闭留足缓冲时间：

server:
  shutdown: graceful
spring:
  lifecycle:
    # 时长需大于你设置的消费者shutdownTimeout，这里设70秒预留10秒缓冲
    timeout-per-shutdown-phase: 70s

2. 给对应消费通道配置Rabbit Binder的容器参数，避免默认值覆盖自定义配置：

spring:
  cloud:
    stream:
      rabbit:
        bindings:
          # 替换为你实际的输入通道名，即LongScenarioSink.INPUT对应的配置名
          long-scenario-sink-input:
            consumer:
              container-settings:
                shutdown-timeout: 60000

如果你不想每个通道单独配置，也可以保留你写的ListenerContainerCustomizer，但必须在全局Rabbit Binder配置中把shutdownTimeout设为匹配的值，避免被默认值覆盖。

• 停机时必须使用正常终止信号（比如kill -2、kill -15，或者容器编排平台的正常停止指令），使用kill -9强杀进程时JVM不会执行任何优雅关闭逻辑，所有相关配置都不会生效。
• 配置生效后，在消费逻辑执行50秒休眠的阶段触发停机，服务会等待业务逻辑执行完成输出done日志后再退出，不会在5秒时强制中断。

内容的提问来源于stack exchange，提问作者weikangchia