根本原因是未安装或未启用Tomcat插件；需在Settings→Plugins中启用“Tomcat and TomEE”，重启IDEA，Community版不支持该插件。
IDEA里点“Add Configuration”找不到Tomcat Server选项
根本原因是没装或没启用Tomcat插件。IDEA默认不激活这个功能，不是Bug，也不是项目配置问题。
- 打开 Settings → Plugins，搜索
Tomcat and TomEE，确保已勾选启用（不是“Installed”就完事，必须打勾） - 重启IDEA——很多人跳过这步，插件不会热加载
- 如果用的是IDEA Community版，该插件不可用，得换Ultimate版或改用外部启动方式
配置Tomcat时提示“Cannot detect server home”或“No valid JRE configured”
这两个报错本质都是路径和环境没对齐：IDEA需要明确知道Tomcat解压目录在哪，且JDK版本必须匹配Tomcat要求（比如Tomcat 10+ 要 JDK 11+）。
-
TOMCAT_HOME必须指向解压后的根目录（含bin、conf、webapps的那个文件夹），不能是压缩包路径，也不能是bin子目录 - 在运行配置的
JRE下拉框里，选一个已配置好的、版本合规的JDK；别用项目默认JDK，它可能只是编译用的 - Windows下路径含空格（如
C:\Program Files\...）容易触发解析失败，建议移到C:\tomcat\这类无空格路径
部署Web应用后访问404，但控制台显示“Server startup in XXX ms”
说明Tomcat起来了，但你的应用根本没被加载——大概率是Artifact没配对，或者war包没生成。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 检查 Deployment 标签页：是否添加了正确的
Artifact？常见错误是加了exploded但没勾选Deploy at the server startup - 确认Artifact类型：Spring Boot项目不该选
war exploded，而应选jar或直接用内置Tomcat；传统Servlet项目才用war exploded - 手动触发构建：
Build → Build Artifacts → Build，否则IDEA不会自动生成部署内容，尤其第一次配置时容易漏 - 访问路径不是
http://localhost:8080/就一定对——要看Deployment里的Application context，默认是/，但改过就是/myapp这种
修改Java代码后热更新失效，每次都要重启Tomcat
热更新（HotSwap）只对方法体内的逻辑变更有效，类结构变动（增删方法、改签名、改字段）必然失败，这是JVM限制，不是IDEA或Tomcat的锅。
- 确保开启了
On 'Update' action → Update classes and resources和On frame deactivation → Update classes and resources - 按
Ctrl+F10（Windows/Linux）或Cmd+F10（Mac）手动触发update，别只靠失焦自动更新——有时卡住没反应 - 如果用Lombok，记得开启
Enable annotation processing，否则生成的getter/setter不会进class，热更后看起来像没变 - 真正省时间的方式不是依赖热更，而是把频繁调试的模块抽成独立服务，用TestNG/JUnit快速验证逻辑
Tomcat集成最麻烦的从来不是按钮点哪，而是路径、JDK、Artifact、context这四层之间互相咬合的细节。少一个条件对不上，就卡在某个404或空指针里，还查不到原因。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
