Spring Shell 3.3+ 版本默认禁用交互式终端，需显式启用 spring.shell.interactive.enabled=true 才能显示命令行提示符并保持应用运行。

spring shell 3.3+ 版本默认禁用交互式终端，需显式启用 `spring.shell.interactive.enabled=true` 才能显示命令行提示符并保持应用运行。

你遇到的问题——Spring Boot 启动成功后瞬间关闭、控制台无任何 Shell 提示（如 shell:>），也无报错日志，是 Spring Shell v3.x 系统性行为变更导致的典型现象。根本原因在于：自 Spring Shell 3.3.0 起，交互式 Shell（Interactive Shell）默认被完全禁用，即使你已正确引入依赖、定义 @ShellComponent 命令类，应用仍会完成上下文刷新后立即退出（表现为 Started Main in X.XXX seconds 后紧接 Closing ...ApplicationContext）。

✅ 正确解决方案：启用交互式 Shell

在 src/main/resources/application.properties 中添加以下两行配置：

# 必须启用交互式 Shell（核心修复项）
spring.shell.interactive.enabled=true

# （可选但推荐）启用脚本模式支持（便于后续执行 .shell 脚本）
spring.shell.script.enabled=true

⚠️ 注意：仅 spring.shell.interactive.enabled=true 就足以恢复交互式终端；若省略此配置，无论命令类是否正确、依赖是否完整，Shell 都不会启动。

? 补充验证与最佳实践

1. 检查 Spring Shell 版本兼容性

你的 pom.xml 中使用的是：

<dependency>
  <groupId>org.springframework.shell</groupId>
  <artifactId>spring-shell-starter</artifactId>
  <version>2.1.5</version> <!-- ❌ 问题根源！ -->
</dependency>

⚠️ 严重不匹配：spring-shell-starter 2.1.5 是 Spring Shell 2.x 的旧版，而你项目中使用的是 Spring Boot 3.0.6（基于 Spring Framework 6.x）。Spring Shell 2.x 不兼容 Spring Boot 3.x，会导致自动配置失效、ShellApplicationRunner 未注册、Bean 扫描异常等静默失败。

✅ 正确做法：升级为 Spring Shell 3.x 官方 starter（与 Spring Boot 3 兼容）：

<dependency>
  <groupId>org.springframework.shell</groupId>
  <artifactId>spring-shell-starter</artifactId>
  <version>3.2.3</version> <!-- 推荐使用最新 3.x 稳定版 -->
</dependency>

✅ Spring Shell 3.x 与 Spring Boot 3.x 完全对齐，自动配置 InteractiveShellApplicationRunner，且默认支持 @ShellMethod 注解无需额外配置。

2. 确保主类与打包方式正确

• 你的 Main.java 使用 @SpringBootApplication 正确，无需修改；
• Maven Assembly 插件生成 jar-with-dependencies.jar 可用，但更推荐使用 Spring Boot 官方 spring-boot-maven-plugin（自动处理启动类、依赖、ClassLoader）：

  <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
  </plugin>

  构建后执行 java -jar target/cli-1.0.jar 即可。

3. 验证命令类规范（次要但重要）

• @ShellComponent 已足够（Spring Shell 3.x 不再需要 @Component）；
• 确保命令方法无参数类型歧义：你代码中 consultDisponibility(String enrollment, Date start, Date end) 使用 java.util.Date，但 Spring Shell 默认不支持直接解析 Date（需自定义 Converter 或改用 String + 手动解析）。建议初调时先简化参数：

  @ShellMethod("Test command")
  public String hello(String name) {
      return "Hello, " + name + "!";
  }

✅ 最终效果

添加配置并升级依赖后，再次运行：

mvn clean package
java -jar target/cli-1.0.jar

你将看到：

  .   ____          _            __ _ _
 /\ / ___'_ __ _ _(_)_ __  __ _    
( ( )___ | '_ | '_| | '_ / _` |    
 \/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |___, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::                (v3.0.6)

... [INFO] Started Main in ...
shell:> 

此时已进入交互式 Shell，可直接输入 hello world 或你的自定义命令。

? 总结

问题现象	根本原因	解决动作
启动即退出、无 shell:> 提示	Spring Shell 3.x 默认禁用交互模式 + 版本不兼容（2.x vs SB3）	① 添加 spring.shell.interactive.enabled=true ② 升级 spring-shell-starter 至 3.2.x ③（推荐）改用 spring-boot-maven-plugin 打包

遵循以上三步，即可彻底解决 Spring Shell 在 Spring Boot 3 环境下“静默退出、无法交互”的问题，让 CLI 应用真正可用。