在IntelliJ IDEA里配置Tomcat,最快的方式是:先确认你用的是Ultimate版,然后通过Run/Debug Configurations直接关联本地Tomcat目录,加一个Artifact部署包,点启动就能跑起来。社区版没有自带这项功能,需要绕路走Maven或第三方插件,下面按实操顺序拆开讲。
IDEA怎么配置Tomcat服务器:新版本界面分步指南
以2024.x和2026.x版本的IntelliJ IDEA为例,界面比旧版简化不少,整体路径是File → Settings → Build, Execution, Deployment → Application Servers,但日常启动Tomcat不需要在这里配。
第一步:检查你的IDEA版本
- 打开IDEA,点菜单栏
Help → About,看版本号。 - 版本名带
Ultimate的,才有完整的Tomcat集成。 - 版本名是
Community的,没有Tomcat Server选项,别浪费时间找。
第二步:在IDEA中新增Tomcat服务器
依次点开Run → Edit Configurations,打开后看左上角号。
- 点击,滚动找到
Tomcat Server。 - 选
Local,这里指的是本机Tomcat。 - 在
Application server旁边点Configure,弹出Tomcat Home目录选择框。 - 选到你解压的Tomcat根目录,比如
D:apache-tomcat-9.0.98,IDEA自动识别版本号。 Tomcat base directory默认跟着Home走,不用改,除非你做了多实例。
第三步:配置部署包(最关键的一步)
很多人在上一步直接点运行,结果是404,问题就出在这里没告诉Tomcat跑哪个项目。
回到Run/Debug Configurations窗口,看右侧Deployment标签页。
- 点击,选
Artifact。 - 弹出的列表里,选你项目的
war exploded或war。日常开发建议选war exploded,改动代码后热部署更快,不用反复重启整个Tomcat。 Application context这一栏填根路径,比如填/api,那访问地址就是http://localhost:8080/api
,留空则访问
http://localhost:8080/。
第四步:验证端口和JRE
- 切到
Server标签页,HTTP port默认8080,如果本地端口占用,改成8081或8082。 JRE这一项选你项目实际用的JDK版本,Tomcat 9配JDK 8或11都行,Tomcat 10.1以上需要JDK 11+。- 点
Apply保存,再点右上角绿色三角启动。
IDEA配置Tomcat不生效?从这三处排查
打开浏览器看到404,或者点击运行根本没反应,这类问题非常常见,不生效一般不是IDEA坏了,而是三个环节出了岔子。
没有Artifact导致的404
现象是Tomcat起来了,日志显示Server startup,但浏览器报404,多数情况下是因为Deployment里没添加项目。
处理办法:回头检查项目是否构建过,打开右侧Maven面板,先clean再package,然后回到Deployment里选Artifact,如果你项目里连Artifact都建不出来,说明Facets没配好。
按下Ctrl+Alt+Shift+S打开Project Structure,依次点Facets和Artifacts,确认有Web相关的Facet存在,没有的话手动添加Web并指定web.xml位置。
端口占用导致启动秒退
现象是IDEA控制台报Port 8080 was already in use。
处理办法:改端口就行,在Run/Debug Configurations里的Tomcat Server配置中,把HTTP port改成8081、8082等,同时检查JMX port是否冲突,这是一个比较经典的反直觉点:改端口时不仅是HTTP端口,JMX端口也可能被占用,两个都要改。
Tomcat版本与JDK不兼容
现象是启动日志出现UnsupportedClassVersionError,或者Tomcat服务起来瞬间消失。
处理办法:确认Tomcat版本对应的Java版本,业内专家指出Tomcat 9及以下版本对JDK 8兼容性最好,Tomcat 10和10.1则需要JDK 11或更高,如果你的项目是JDK 17,却装了Tomcat 8.5,启动失败是必然的。

IDEA社区版配置Tomcat:没有选项的替代方案
社区版用户经常误以为是自己没找对地方,实际上IDEA Commons版从底层砍掉了对Tomcat等应用服务器的集成,想在社区版里跑Web项目,有一个比插件更省事的路径。
用Maven插件启动Tomcat
这是社区版里最常用的方式,不需要装额外插件。
核心思路是:在pom.xml里加上tomcat7-maven-plugin,然后通过Maven命令启动。
- 在项目的
pom.xml文件末尾<plugins>节点内,加一个Tomcat插件,设置port和path。 - 在IDEA右侧
Maven面板找到项目的Plugins目录,展开tomcat7,双击tomcat7:run。 - 控制台输出
Starting ProtocolHandler后,访问http://localhost:8080/。
这个方案的好处是社区版和Ultimate版通用,缺点是Tomcat 7插件不支持Servlet 4.0以上的规范,因为底层跑的是Tomcat 7容器,只支持Servlet 3.0,如果想用新版Tomcat,只能用外部Tomcat配合Run/Debug Configurations里的Remote Server方式,但这需要配置JMX远程连接,步骤繁琐且不稳定。
安装Smart Tomcat插件
在File → Settings → Plugins里搜索Smart Tomcat,安装后重启IDEA,在Edit Configurations左侧里会出现Smart Tomcat选项。
不过在具体实践中,Smart Tomcat对老旧项目的兼容性一般,它只负责把项目部署到Tomcat的webapps目录,遇到复杂多Module项目时经常需要手动指定上下文路径,社区版用户如果遇到麻烦,建议优先考虑Maven方案。
IDEA配置Tomcat后的运行验证与日常操作
如何确认配置成功
- 启动后看控制台日志:找
INFO [main] org.apache.catalina.startup.Catalina.start Server startup,看到这行代表Tomcat正常启动。 - 然后再看IDEA底部的
Services窗口,Tomcat Server会显示绿色运行状态。 - 浏览器地址栏输入
http://localhost:端口号/应用上下文路径
,出现项目首页即成功。
热部署设置
开发阶段频繁改代码,不会有人愿意每次重启Tomcat,在Run/Debug Configurations的Server标签页里,找到On frame deactivation,改成Update resources,意味着IDE失去焦点时自动把更新的资源同步到Tomcat,改Java代码时点Update按钮然后选Update classes and resources即可。
关于IDEA配置Tomcat的常见问题
IDEA配置Tomcat后启动失败,日志或报错提示找不到Tomcat服务怎么办
先看Edit Configurations里Application server是不是红的,如果是红色提示,说明IDEA没有关联到Tomcat目录,点击Configure重新选择Tomcat根目录,注意必须选到包含bin、conf、lib这些子目录的文件夹,不能选到bin里,否则不识别。
WAR和WAR EXPLODED有什么区别,开发中选哪种
这两种模式的核心差异在于部署方式。war exploded是解压后的目录,IDEA直接把项目out目录下的资源关联到Tomcat,支持资源热更新,调试和开发效率高。war是打成一个压缩包放进去再解压,更贴近正式发布流程,但每次改动都要重新打包,开发阶段不推荐,现场快速演示或本地测试时用war exploded,准备发布到线上环境时用war。
IDEA配置Tomcat的配置信息存储在哪个文件里
IDEA会把Tomcat配置存放在项目的.idea目录下,文件名是workspace.xml,里面<component name="RunManager">节点内能看到Tomcat的端口、部署名称、服务器目录等配置,这也是为什么不建议直接拷贝.idea给别人做项目分享,因为本机路径不同,容易导致传输后Tomcat配置失效,据JetBrains官方文档说明,artifacts.xml和workspace.xml都属于项目本地配置,不可提交到版本控制系统共享。
