在STS(Spring Tool Suite)里配置Tomcat,核心路径只有一条:打开Window→Preferences→Server→Runtime Environments,添加本地Tomcat目录,再在Servers视图新建Server并关联项目,多数启动失败都与端口冲突、Server视图缺失或Tomcat版本不匹配有关,按步骤排查即可解决。
sts怎么配置tomcat:从零开始的完整思路
新手常把STS配置Tomcat想复杂,其实拆开看就三件事:先确认本机有Tomcat,再让STS识别这个Tomcat,最后创建一个Server把Web项目挂上去,STS本质上是Eclipse套了Spring插件,所以配置Tomcat的底层逻辑和Eclipse几乎一样。
不用先急着改配置文件,先走一遍界面配置,跑通后再根据项目需要调整端口和部署方式。
sts配置tomcat详细步骤:先装Tomcat还是先配STS
顺序无所谓,但建议先下载解压Tomcat,因为配置时要用到它的根目录,Tomcat官网提供zip和exe两种包,开发环境更推荐zip免安装版,目录干净、迁移方便。
确认Tomcat目录可用
- 解压后的Tomcat目录里应有bin、conf、webapps、lib四个核心文件夹。
- 双击bin目录下的startup.bat(Windows)或运行startup.sh(macOS/Linux)能正常启动。
- 浏览器访问
http://localhost:8080能看到Tomcat默认欢迎页,说明本机环境没问题。
在STS里添加Runtime Environment
- 打开STS,点击顶部菜单
Window→Preferences。 - 左侧展开
Server,点击Runtime Environments。 - 点右侧
Add,选择你下载的Tomcat版本,例如Apache Tomcat v9.0。 - 勾选
Create a new local server,点Next。 - 在
Tomcat installation directory一栏选择刚才解压的Tomcat根目录。 - JRE保持默认或选择本机安装的JDK,点
Finish。
打开Servers视图并新建Server
- 如果STS界面下方没有Servers标签,先看本文后面“没有server选项怎么办”那一节。
- 点击下方
Servers标签,在空白处右键→New→Server。 - 选择刚才添加的Tomcat运行时,点
Next。 - 把左侧需要部署的Web项目添加到右侧
Configured列表,点Finish。
启动并验证

- 双击Servers视图里的Tomcat Server,检查
Server Locations是否勾选Use Tomcat installation。 - 右键Server→
Start,等待控制台出现Server startup in字样。 - 浏览器访问
http://localhost:8080/项目名,看到页面即配置成功。
如果控制台提示端口被占用,先不要改代码,去Server配置里把HTTP端口换掉。
sts和eclipse配置tomcat区别:为什么STS更省事
很多从Eclipse转到STS的人会问:sts和eclipse配置tomcat区别到底在哪?两者的Tomcat配置界面几乎完全一致,因为STS就是基于Eclipse构建的,区别主要在工作流和默认视图上。
以下是两者的核心差异:
| 对比项 | Eclipse | STS |
|---|---|---|
| 运行底层 | Eclipse平台 | Eclipse平台+Spring插件集 |
| Tomcat配置入口 | Windows→Preferences→Server | 完全相同的路径 |
| Servers视图 | 默认显示 | 部分版本需手动调出 |
| Spring Boot项目 | 通常需要配置外部Tomcat | 可直接用内嵌容器运行,不一定需要外部Tomcat |
| 传统War项目 | 必须配置外部Tomcat | 同样必须配置外部Tomcat |
行业共识认为,如果只做传统Servlet或JSP项目,用Eclipse直接配Tomcat更轻量;如果做Spring Boot开发,STS的内嵌容器能力会减少对本地Tomcat的依赖,但配置步骤没有本质区别,学会一个,另一个也会了。
需要注意的是,有些STS版本的Server视图不默认出现在Java透视图下,需要切到Java EE透视图或手动打开视图,这并不是STS更麻烦,只是Spring工具集对视图布局做了调整。
本地sts配置tomcat运行web项目:从启动到验证
本地sts配置tomcat运行web项目时,最容易卡住的地方不是配置本身,而是项目结构和Server部署方式,这里按真实场景走一遍。
先确认项目类型,如果是Maven构建的War项目,STS能自动识别;如果是普通Dynamic Web Project,需要在创建时勾选Generate web.xml deployment descriptor,否则缺配置文件会导致404。
运行前检查三项:

- 项目右键→
Properties→Project Facets,确认Dynamic Web Module和Java已勾选。 - 项目右键→
Build Path→Configure Build Path,确认src/main/java和src/main/resources是源目录。 - 双击Server,在
Modules标签里确认该项目已添加,且Path是/项目名。
启动后如果首页404,多数情况是访问路径写错,Tomcat部署Web项目时默认带项目名,例如项目叫demo,访问地址就是http://localhost:8080/demo/,如果不想带项目名,可以在Server的Modules里将Path改为,但要注意这会让默认欢迎页占用根路径。
控制台输出Deploying web application directory后,再刷新页面,若仍报404,检查web.xml里是否配置了欢迎文件,或直接访问具体Servlet路径。
sts配置tomcat没有server选项怎么办
这个问题出现频率很高。sts配置tomcat没有server选项怎么办的核心原因通常有两个:视图没打开,或缺少JST Server Adapter插件。
先按下面顺序排查:
- 顶部菜单
Window→Show View→Other→Server→Servers,双击打开。 - 如果
Other里根本没有Server文件夹,说明缺少服务插件。 - 点击
Help→Eclipse Marketplace,搜索JST Server Adapter,安装后重启STS。 - 如果公司网络不能访问Marketplace,用离线安装:
Help→Install New Software,在Work with里填入对应Eclipse版本的更新源,找到Web, XML, Java EE and OSGi Enterprise Development下的JST Server Adapter。
部分老版STS在Window→Preferences里看不到Server条目,也是同样的原因,安装插件后,Preferences、Servers视图、New Server向导会一起出现。
查看STS版本的方法是Help→About Spring Tool Suite,不同大版本对应的更新源地址不一样,但插件名称都叫JST Server Adapter,专家指出,大多数“没有Server选项”的情况只需安装这一个插件即可解决,无需重装IDE。
sts配置tomcat端口冲突与启动失败排查

端口冲突是启动失败的第一大原因,STS里改端口不用去翻server.xml,直接双击Servers视图里的Tomcat Server,在Ports区域修改HTTP/1.1端口即可,改成8081、8090等不常用端口能避开大部分冲突。
如果启动时提示Several ports (8005, 8080, 8009) required by Tomcat v9.0 Server at localhost are already in use,说明不止一个端口被占,此时可以:
- 检查是否本机已经手动运行了独立的Tomcat,关掉它。
- 检查STS里是否重复创建了多个Tomcat Server,停掉多余Server。
- Windows下用命令
netstat -ano | findstr 8080找到占用进程PID,再用任务管理器结束对应进程。
启动失败的另一个常见原因是JDK版本过旧,Tomcat 9需要Java 8及以上,Tomcat 10需要Java 11及以上,如果STS里配置的JRE是低版本,启动会报UnsupportedClassVersionError,解决办法是在Window→Preferences→Java→Installed JREs里添加正确JDK,并在Server的Runtime Environment里切换。
Q&A:sts配置tomcat高频疑问
Q:sts配置tomcat需要单独下载Tomcat吗?
需要,STS本身不包含Tomcat安装包,只提供配置入口,你需要到Apache Tomcat官网下载解压版,再在STS的Runtime Environments里指定目录,如果本机已经装了XAMPP或其他集成环境,也可以指向其中的Tomcat目录,但不建议混用版本。
Q:sts配置tomcat9和tomcat10有区别吗?
有,Tomcat 9使用javax.servlet命名空间,Tomcat 10使用jakarta.servlet命名空间,如果你的Web项目基于旧版Servlet API,选Tomcat 9;如果项目已经升级到Jakarta EE 9以上,才选Tomcat 10,选择错误会导致项目启动时找不到Servlet类,STS里不同Tomcat版本对应的运行时选项不同,添加时别选错。
Q:sts配置tomcat启动后访问404怎么处理?
先确认项目是否真的部署到了Tomcat,双击Server,看Modules标签里有没有该项目,没有就手动添加,再看控制台有没有Deploying web application,如果部署了但404,多半是访问路径不对,加上项目名再试,最后检查项目里有没有web.xml或@WebServlet映射,没有映射直接访问根路径确实会404。
