微信优化

weixinyouhua

sts配置tomcat如何实现,sts配置tomcat具体步骤?

2026-09-18 10:22:35

在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。

启动并验证

sts配置tomcat如何实现,sts配置tomcat具体步骤?

  • 双击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。

运行前检查三项:

sts配置tomcat如何实现,sts配置tomcat具体步骤?

  • 项目右键→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配置tomcat如何实现,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。

相关文章

2024年,SaaS软件行业碰到获客难、增长慢等问题吗?

我们努力让每一次邂逅总能超越期待