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 应用真正可用。
