Spring Tool Suite运行时环境无法识别添加JBOSS EAP 7.0.0问题

优先定位最高概率根因：版本兼容性不匹配 #

• JBoss EAP 7.0.0 官方适配的运行JDK版本仅覆盖Java 8及早期预览版Java 11，完全不兼容Java 15及以上高版本JDK。STS内置的JBoss运行时探测逻辑会自动校验目标服务器的JDK适配范围，一旦识别到当前关联的JDK为Java 15，会直接跳过该服务器实例的识别流程，这是当前场景下最核心的问题来源。
• 对应修复操作：在STS的JRE配置页新增一个独立的Java 8版本运行环境，所有关联JBoss EAP 7.0.0的配置都绑定到这个低版本JDK，不要沿用当前Java 15的全局默认JRE设置。

排查STS内置的JBoss适配插件缺失/版本不匹配问题 #

• STS默认不会预装全版本JBoss EAP的适配组件，对JBoss EAP 7.0.0的识别能力完全依赖对应版本的JBoss Tools插件。如果当前安装的JBoss Tools是仅适配EAP 7.2及以上版本的高版本，插件会直接移除对7.0.0版本的支持，自然不会在运行时下拉列表中展示该选项。
• 对应排查操作：通过STS的Help > Eclipse Marketplace入口，选择适配JBoss EAP 7.0支持区间的JBoss Tools版本完成安装，不要直接安装仅支持高版本EAP的最新版插件包。

排查JBoss安装目录结构校验不通过的问题 #

• STS识别JBoss运行时会严格校验安装目录的固定结构要求：必须在选定的JBoss Home根目录下找到jboss-modules.jar、standalone/configuration、domain/configuration三类固定文件/目录。之前手动将jboss-modules.jar复制到JDK安装目录的操作对识别过程完全没有帮助，因为STS的探测逻辑根本不会遍历JDK目录查找该文件，反而可能因为JBoss根目录下的jboss-modules.jar缺失导致探测直接失败。
• 对应校验操作：确认选择的JBoss Home路径直接指向EAP解压后的根目录，不要选到bin、modules等下层子目录；如果之前移动过根目录下的jboss-modules.jar，需要把文件移回EAP根目录，保证原始解压的目录结构完整。

排查自定义系统环境变量的干扰 #

• STS的运行时识别逻辑不会直接读取全局配置的系统环境变量，仅会加载自身配置面板中设置的JRE、服务器路径参数。如果全局配置的JAVA_HOME、JBOSS_HOME指向的是Java 15版本，STS启动时会默认将其关联为全局运行时，进一步放大识别失败的问题。
• 对应排查操作：打开STS的Preferences > Java > Installed JREs配置页，确认默认JRE和JBoss关联的JRE版本符合适配要求，不要直接复用全局环境变量的路径配置。

绕开内置探测逻辑的手动添加方案 #

如果以上排查完成后，依然无法在下拉列表找到JBoss EAP 7.0.0的选项，可以手动新建运行时：在Preferences > Server > Runtime Environments页面点击Add，选择JBoss Community > JBoss 7.0对应选项，在后续配置页填入合规的JBoss安装目录、绑定匹配版本的JRE即可完成添加。

补充说明：插件安装完成后仅需要重启STS即可生效，反复重启操作系统对识别过程没有实质帮助。

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