在IDEA里给项目加服务器,本质是配置一个应用服务器运行时环境,让IDE知道用什么容器跑你的代码。
IntelliJ IDEA给项目加服务器的核心操作路径是:File → Settings → Build, Execution, Deployment → Application Servers,点击“+”号选择服务器类型并指定本地安装目录,完成配置后自动出现在运行配置中。 说白了,IDEA本身不提供服务器,它做的是“托管管理”把外部的Tomcat、TomEE等容器接进来,让编译、部署、启动一条龙在IDE内完成。
但实际情况往往比路径复杂得多,有人卡在找不到Application Servers入口,有人配完了跑不起来,有人用社区版压根没这个功能,下面按实际遇到的场景拆开讲。
先搞清楚:你说的“加服务器”到底是哪种
这个问题的搜索意图其实分两类,方向完全不同,先对号入座再往下看。
- 加应用服务器(Web容器) :项目是Java Web应用,需要在IDEA里配Tomcat/Jetty/WebLogic等,让项目能本地跑起来调试,这是绝大多数人问“idea怎么给一个项目加服务器”时的真实需求。
- 加远程部署服务器:项目要部署到云服务器或测试机,想在IDEA里配远程连接、一键上传、远程调试,走的是Deployment配置或Remote Host路径。
两类操作入口不同、配置项不同,混着找会浪费很多时间。
IntelliJ IDEA给Java Web项目配置Tomcat服务器详细步骤
以最常见的Tomcat为例,这是配置应用服务器的标准流程。
前置条件确认
在动手之前,确认三件事:
- IDEA版本是Ultimate版(社区版没有Application Servers功能,后面单独说)。
- 本地已经下载并解压了Tomcat,记下安装路径,建议用Tomcat 8.5/9.0/10.0,注意Tomcat 10的包名从
javax.变成了jakarta.,老项目用9.0更稳妥。 - 项目已经能被IDEA识别为Web项目,即存在
web目录或src/main/webapp结构,且部署描述符web.xml存在(Servlet 3.0之后可注解替代,但目录结构要规范)。
配置Application Servers入口
- 打开 File → Settings(Mac是IntelliJ IDEA → Preferences)。
- 左侧导航到 Build, Execution, Deployment → Application Servers。
- 点左上角 ,下拉列表选 Tomcat Server。
- 在弹出的窗口里,Tomcat Home一栏指定本地Tomcat根目录,IDEA会自动识别版本号,下方会显示该Tomcat的lib路径。
- 点 OK 保存。
配完后,这个Tomcat就出现在“可用服务器”列表里了,后续每个项目都能复用,不用重复指定路径。
创建运行配置并部署项目
- 点右上角运行配置下拉框 → Edit Configurations。
- 点 → 选 Tomcat Server → Local。
- Server选项卡:确认Tomcat实例是刚才配好的那个;
Open browser勾上,URL填http://localhost:8080/你的context路径;HTTP port默认8080,被占用就改。 - Deployment选项卡:点 → Artifact,选项目的war exploded或war包。这一步不配,启动时会报“no artifacts marked for deployment” ,是新手最高频的坑,下面的
Application context决定访问路径,填就是根路径访问。 - Apply → OK。
回到主界面,运行按钮旁边出现Tomcat图标,点运行或调试,IDEA自动完成编译、打包、部署、启动容器,控制台看到Server startup in xxx ms即成功。
idea配置服务器报错的几个高频场景
配置过程中报错很常见,多数不是IDEA本身的问题。
启动报“Artifact not found”或“no artifacts marked for deployment”
回到Deployment选项卡,确认已添加Artifact,如果Artifact列表是空的,说明项目还没配置构建产物去 File → Project Structure → Artifacts 里新建一个Web Application: Exploded,指定模块和web资源目录,输出目录设到target或out下即可。
端口被占用:Address already in use
8080是重灾区,多半是上次Tomcat没正常关闭,或者本机跑了其他Web服务,排查命令:
# Windows
netstat -ano | findstr :8080
taskkill /PID <进程号> /F
# Mac/Linux
lsof -i :8080
kill -9 <PID>
不想杀进程就改端口,Server选项卡里把HTTP port换成8081、9090等,注意如果配置了HTTPS,8443端口也要一并检查。
访问404或class not found
三个方向排查:第一,Application context和浏览器URL是否一致;第二,Artifact类型选war exploded还是war开发调试必须用exploded,否则改代码要重新打包;第三,项目依赖的jar是否全部打进Artifact,去Project Structure的Artifacts里看WEB-INF/lib下是否有依赖包。
业内专家指出,部署类问题中相当一部分源于Artifact配置不完整,而非服务器本身故障,排查时优先检查构建产物结构。
idea社区版和专业版配置服务器区别:值不值得为这个功能升级
这是很多人在搜索“idea社区版和专业版配置服务器区别”时的真实纠结点。
| 对比项 | 社区版(Community) | 专业版(Ultimate) |
|---|---|---|
| Application Servers配置 | 不支持 | 支持Tomcat、TomEE、Jetty、WebLogic、WebSphere等 |
| 部署Artifact到容器 | 需手动或靠插件 | 图形化配置,一步到位 |
| 远程部署/远程调试 | 不支持 | 支持SFTP、Docker、SSH |
| Spring/Java EE框架支持 | 基础 | 完整(含Spring Boot运行配置) |
| 价格(订阅制) | 免费 | 按年订阅,机构采购有折扣 |
社区版不是不能跑Web项目,只是要绕路:用Maven的tomcat7-maven-plugin插件启动,或者装第三方Smart Tomcat插件,再或者自己写启动脚本调catalina.bat run,能用,但调试体验和热部署差一截。
行业共识认为,如果项目以Spring Boot内置容器为主,社区版加Maven插件基本够用;如果是传统Servlet/JSP项目、依赖外部容器调试,专业版的Application Servers功能省下的时间成本远超订阅费用,学生和开源项目可以申请免费license,这点别忘了。
项目要部署到云服务器,IDEA里怎么配
本地跑通之后,下一个阶段往往是把项目推到远程机器,这条线走的是Deployment配置。
- Tools → Deployment → Configuration,点“+”选SFTP。
- 填远程主机IP、端口(默认22)、用户名,认证方式选密码或密钥,测试连接通过后,Root path指定远程站点目录。
- Mappings选项卡:本地项目路径映射到远程路径,比如本地
target/xxx.war映射到远程/opt/tomcat/webapps/。 - 配置完成后,右键项目或文件选 Upload to xxx 即可上传。
想更省事,把上传动作绑到构建流程后,或者用 Tools → Start SSH Session 开远程终端直接操作,近年来远程开发场景增多,IDEA的Remote Development和Gateway功能也在迭代,但基础的SFTP部署方式依然是兼容性最好的方案。
一个容易忽略的细节:JDK版本和Tomcat版本的匹配
配服务器时IDE不拦你,但跑起来会出各种诡异错误,根因常在版本组合上,参考对应关系:
- Tomcat 9.x → JDK 8及以上,Servlet 4.0
- Tomcat 10.x → JDK 8及以上,但包名迁移到
jakarta.,老代码直接迁会编译不过 - Tomcat 11.x(较新)→ 建议JDK 17+
项目编译用的JDK、Tomcat运行用的JRE、IDEA项目结构里设的SDK,三者最好一致或向下兼容,在 Project Structure → Project 里统一设置,Server选项卡的JRE也确认指向正确版本,版本错配的典型症状是启动时报UnsupportedClassVersionError。
Q&A:idea给项目加服务器常见疑问
Q:idea怎么给一个非Web的普通Java项目加服务器?
普通Java SE项目不需要应用服务器,直接运行main方法即可。“加服务器”对它无意义,如果非要挂到容器里跑(比如测试某些容器特性),把项目改造成Web项目结构,或写一个Servlet入口包装调用逻辑,再走上面的Tomcat配置流程,多数情况下没必要。
Q:同一个项目能同时配置多个服务器做对比测试吗?
可以,在Edit Configurations里复制一份配置,换一个Tomcat实例或改端口即可并行运行,注意两个实例的HTTP端口、JMX端口、shutdown端口不能冲突,否则后启动的会失败。
Q:IntelliJ IDEA配置Tomcat后启动特别慢,正常吗?
首次启动包含编译和Artifact构建,耗时属正常,如果每次都慢,检查是否每次都在重新构建Artifact,或Tomcat的server.xml里配置了不必要的连接器,把Artifact类型固定为war exploded、关闭不必要的Update resources动作,启动速度会有明显改善,另据统计,机械硬盘环境下Tomcat冷启动比SSD慢数倍,硬件因素同样不可忽视。
IDEA给项目加服务器的完整链路,就是先配好Application Servers这个“容器注册表”,再在运行配置里把项目Artifact挂上去,两条腿缺一不可,版本匹配和Artifact完整性是决定成败的两个隐性变量,配之前花两分钟确认,比配完再排查省事得多。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/798347.html


