eclipse配置server的核心思路只有两步:先在Window > Preferences > Server > Runtime Environments里添加Tomcat运行时环境,再通过Servers视图创建Server实例并把Web项目部署进去,整个过程不需要修改Eclipse安装目录本身。
eclipse配置tomcat服务器详细步骤:从下载到跑通第一个web项目
不少开发者第一次接触eclipse配置server时会觉得界面复杂,其实真正的关键点只有两个:运行时环境和Server实例,只要把这层关系搞清楚,后面所有操作都是重复劳动。
先确认你下载的Eclipse版本
Eclipse官方提供多种打包版本,如果你下载的是“Eclipse IDE for Java Developers”,它默认不带Web开发时需要的Server插件,配置起来会非常痛苦,建议直接下载Eclipse IDE for Enterprise Java and Web Developers,这个版本内置了Web Tools Platform,包含Server运行时管理和Servers视图。
版本匹配参考下表:
| Eclipse版本 | 内置Server插件 | 推荐Tomcat版本 | JDK要求 |
|---|---|---|---|
| 2020-06 及以后 | 有 | Tomcat 9.0.x | JDK 8 或以上 |
| 2021-06 及以后 | 有 | Tomcat 10.0.x | JDK 11 或以上 |
| 2019-12 及以前 | 需手动装插件 | Tomcat 8.5.x | JDK 8 |
多数情况下,国内开发者在公司老项目中仍以JDK 8 + Tomcat 9组合为主,如果你是新项目,可以考虑Tomcat 10,但要注意它修改了命名空间,很多老依赖不兼容。
步骤1:添加Tomcat运行时环境
打开Eclipse后,按下面路径操作:
- 点击顶部菜单栏
Window - 选择
Preferences - 在左侧搜索框输入
Server - 点击
Runtime Environments - 点击右侧
Add...按钮 - 选择对应Tomcat版本,
Apache Tomcat v9.0 - 点击
Next - 在
Tomcat installation directory中选择你解压后的Tomcat目录 - JRE选择你本机的JDK版本
- 点击
Finish
这一步做完,Eclipse就认识了Tomcat安装在哪个位置,但它还不会自动帮你启动。
步骤2:创建Server实例
运行时环境添加后,还需要创建一个Server实例:
- 顶部菜单
Window->Show View->Servers - 在Servers面板空白处右键 ->
New->Server - 选择刚才添加的运行时
Server's host name默认localhost
- 点击
Finish
创建完成后,Servers面板会多出一个服务器条目,双击它就可以进入详细配置页,看到端口、部署路径等设置。
步骤3:部署Web项目到Server
- 右键Servers面板里的Tomcat服务器
- 选择
Add and Remove... - 左侧是你的项目列表,选中一个动态Web项目
- 点击
Add >移到右侧 - 点击
Finish - 右键服务器 ->
Start
如果一切正常,控制台会输出Tomcat启动日志,浏览器访问 http://localhost:8080/项目名 就能看到页面。
eclipse没有server选项怎么调出来?先检查这两处
“eclipse没有server选项怎么调出来”是搜索量相当高的一个问题,很多教程默认你的Eclipse有Server视图,结果你打开后连 Servers 都找不到。
安装了纯Java版Eclipse
这是最常见的场景,你下载的是基础Java开发版,里面没有Web工具组件,解决方法有两种:
- 重装:直接去官网下载 Eclipse IDE for Enterprise Java and Web Developers 版本,省去后续各种补丁。
- 安装插件:在当前Eclipse里点
Help->Install New Software...,在Work with下拉框选择--All Available Sites--,等列表加载后搜索server,勾选JST Server Adapters和JST Server UI,一路安装并重启。
行业共识认为,新增开发者或不想折腾插件的情况下,直接重装企业版更省时间。
视图被手动关闭
如果Eclipse的确是Enterprise版本,但Servers面板不见了,只是视图被关掉:
- 点击
Window->Show View->Other... - 在搜索框输入
Servers - 双击
Servers即可重新打开
如果你的Perspective还停留在Java模式,部分Web工具可能不显示,可以在右上角切换到 Java EE 或 Jakarta EE 透视窗口。
eclipse配置server运行web项目:端口修改与部署路径调整
“eclipse配置server运行web项目”时最常见的两个需求:改端口和改部署目录,双击Servers面板里的Tomcat服务器,打开Overview配置页。
修改HTTP端口
在Overview页找到 Ports 区域:
Tomcat admin port:管理端口,一般保持默认8005HTTP/1.1:默认8080,改成你想要的端口,比如8081或9090AJP/1.3:默认8009,不需要可以改成-1禁用
改完保存,重新启动Tomcat生效,注意,如果你直接在Eclipse里修改,它会把变更写进工作空间的server配置,而不是直接修改Tomcat安装目录下的

server.xml,这是很多初学者会误解的地方。
修改部署路径
在Overview页下方找到 Server Locations 区域:
- 选项
Use workspace metadata:项目部署在工作区元数据里,不会污染Tomcat安装目录 - 选项
Use Tomcat installation:直接使用Tomcat的webapps目录,方便和外部启动方式保持一致
如果你还在开发调试阶段,默认的 Use workspace metadata 就够用,如果希望发布包结构和生产环境一致,可以选择后者,必要时可以把 Deploy path 改成 webapps。
eclipse配置server端口8080被占用:两种处理方式
启动Tomcat时控制台报 Port 8080 required by Tomcat v9.0 Server at localhost is already in use,这就是典型的“eclipse配置server端口8080被占用”问题,解决方法有两种。
找到占用进程并结束
Windows环境在命令行执行:
netstat -ano | findstr :8080
会返回占用8080端口的进程PID,
TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 12345
拿到PID后执行:
taskkill /F /PID 12345
重新启动Tomcat即可,多数情况下,这个端口是被之前启动失败的Tomcat进程、公司内网软件或另一个Java进程占用。
直接修改Eclipse里的Tomcat端口
如果8080被其他重要服务占用,不建议强杀进程,把Tomcat的HTTP端口改成8081、8082即可,具体操作参考上一节修改HTTP端口的步骤。
idea和eclipse配置server对比:免费开源的本地开发方案怎么选
很多人在“idea和eclipse配置server对比”中纠结,两者的定位有明显差异,尤其涉及Web项目本地运行时,Eclipse的开源免费优势很突出。
| 对比项 | Eclipse配置Server | IDEA配置Server |
|---|---|---|
| 费用 | 完全免费开源 | 社区版不支持Tomcat,Ultimate版收费 |
| Tomcat集成 | 内置Servers视图,操作直接 | Ultimate版内置运行配置,社区版需装Smart Tomcat插件 |
| 老项目兼容 | 支持Eclipse工程导入,配置入口清晰 | 需要导入为Maven/Gradle项目再配置 |
| 内存占用 | 较低,适合老旧电脑 | 普遍偏高 |
| 国内使用习惯 | 企业培训、大学课程常见 | 互联网公司较多 |
对于个人学习、中小公司和预算有限的团队,Eclipse配置server依然是可靠选择,它不限制Tomcat版本,不需要付费订阅,也不会突然提示License过期。
eclipse配置tomcat启动报错:两个常见的版本陷阱
Tomcat 10的javax改jakarta问题
如果你下载了Tomcat 10,部署老项目后启动时日志刷出一堆 ClassNotFoundException: javax.servlet.Servlet,不用怀疑配置步骤错了,Tomcat 10开始把命名空间从 javax.servlet 改为 jakarta.servlet,所有没做迁移的旧jar包都会失效。
解决思路有两个:
- 老项目老老实实用Tomcat 9
- 新项目如果必须用Tomcat 10,把servlet依赖全部换成
jakarta.servlet命名空间
动态Web模块版本与Tomcat不匹配
新建Dynamic Web Project时,会让你选择Dynamic web module version,Tomcat 9支持4.0及以下,Tomcat 10支持5.0及以上,如果版本选高了,部署时会提示 Project facet Dynamic Web Module version 4.0 is not supported。
在项目上右键 -> Properties -> Project Facets,把 Dynamic Web Module 改成服务器支持的版本,重新部署即可。
Eclipse配置server本身并不神秘,添加运行时环境”加“创建Server实例”两步,怕的是版本错配、端口冲突、视图找不到这些小问题,只要按照上面的路径逐项检查,本地跑通一个Web项目最多也就十几分钟。
相关问答:eclipse配置server常见疑问
eclipse配置tomcat10需要什么版本的Eclipse?
Tomcat 10要求JDK 11及以上,因此Eclipse版本至少要在2021-06以后,并且运行Eclipse的JDK也必须是11以上,太老的Eclipse会因为自带的Web Tools Platform不支持Tomcat 10而无法选择运行时。
eclipse配置server时无法选择Tomcat 9怎么办?
先在 Window > Preferences > Server > Runtime Environments 确认是否已经添加了Apache Tomcat v9.0,如果这里都添加不了,说明Eclipse缺少对应的Server Adapter,需要到 Help > Install New Software 里安装 JST Server Adapters。
eclipse配置server后为什么项目没有自动部署到Tomcat?
Eclipse的Server实例默认采用 Use workspace metadata 部署方式,项目不会复制到Tomcat安装目录的 webapps 下,这是正常现象,不是配置错误,你可以双击服务器,在 Server Locations 中改成 Use Tomcat installation,这样部署路径就与外部Tomcat启动保持一致,直接启动服务器后访问 http://localhost:8080/项目名 即可验证部署是否成功。

