0

0

Java Web入门如何搭建第一个Servlet应用_Tomcat配置与web.xml请求映射

P粉602998670

P粉602998670

发布时间:2026-03-14 11:28:03

|

338人浏览过

|

来源于php中文网

原创

Tomcat启动报ClassNotFoundException是因10+版将javax.servlet改为jakarta.servlet,解决方法是降级用Tomcat 9.0.90或全面替换包名和web.xml声明。

java web入门如何搭建第一个servlet应用_tomcat配置与web.xml请求映射

Tomcat 启动报 java.lang.ClassNotFoundException: javax.servlet.http.HttpServlet

这是新手最常遇到的错误,本质是 Tomcat 10+ 和老教程不兼容。Servlet API 包名在 Tomcat 10 中从 javax.servlet 改成了 jakarta.servlet,但很多入门教程仍基于 Tomcat 9 或更早版本。

解决方法不是改代码,而是选对版本:

  • 如果你用的是 IntelliJ IDEA 或 Eclipse 新建的 “Dynamic Web Project”,默认可能拉取 Tomcat 10+,直接换成 Tomcat 9.0.90(最新稳定 9.x)最省事
  • 确认 WEB-INF/lib/ 下没有手动塞进 javax.servlet-api.jar —— Tomcat 自带 servlet API,重复引入反而冲突
  • 如果坚持用 Tomcat 10+,所有 import 必须改成 jakarta.servlet.*,且 web.xml 的 schema 声明也要换:
    <web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
             https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
             version="5.0">

web.xml<servlet-mapping> 不生效,访问路径 404

根本原因通常是路径匹配规则没吃透,不是配置漏了,而是写法和请求 URL 对不上。

重点看三处是否一致:

立即学习Java免费学习笔记(深入)”;

  • <servlet-name><servlet><servlet-mapping> 两个地方必须**完全相同**(区分大小写)
  • <url-pattern> 是相对于应用上下文根(context path)的,比如应用部署为 /myapp,而 pattern 写的是 /hello,那真实访问地址是 http://localhost:8080/myapp/hello,不是 /myapp/servlet/hello
  • 不要加多余斜杠:写成 /hello//hello 是两个不同模式;前者只匹配 /hello/(结尾有斜杠),后者才匹配 /hello

示例(Tomcat 9 兼容写法):

Peppertype.ai
Peppertype.ai

高质量AI内容生成软件,它通过使用机器学习来理解用户的需求。

下载
<servlet>
  <servlet-name>HelloServlet</servlet-name>
  <servlet-class>com.example.HelloServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>HelloServlet</servlet-name>
  <url-pattern>/hello</url-pattern>
</servlet-mapping>

IDEA 里点 Run 没反应,或者提示 Artifact not configured

这不是代码问题,是项目打包结构没对上 Tomcat 的预期。IDEA 默认不会自动把 web.xml 和 class 文件组织成标准 WAR 结构。

必须手动检查两件事:

  • 确保 src/main/webapp/WEB-INF/web.xml 存在(Maven 标准布局),而不是放在 src/web/ 下随便一个文件夹里
  • 打开 Project Structure → Artifacts,点击 + 号 → Web Application: Archive → 选中你的模块;再点 + 号 → Web Application: Exploded,同样选中模块;最后确认 Output Directory 指向 out/artifacts/xxx_war_exploded
  • 运行配置里,Deployment 选项卡下要勾选你刚建的那个 exploded artifact,并设置 Application context(比如 /myapp

Servlet 类编译后找不到 doGet() 方法,控制台报 HTTP Status 405 – Method Not Allowed

这个错说明请求确实路由到了 Servlet,但该 Servlet 没重写对应 HTTP 方法的处理函数。

常见陷阱:

  • 写了 get()handleGet() 这种自定义方法 —— 必须是 doGet(HttpServletRequest, HttpServletResponse),签名一个字母都不能错
  • 继承了 GenericServlet 却想用 doGet —— 它没这个方法,得继承 HttpServlet
  • 参数类型写错:比如把 HttpServletResponse 写成 ServletResponse,Java 会当成另一个重载方法,HttpServlet 父类的 doGet 依然没被覆盖

最小可用骨架:

public class HelloServlet extends HttpServlet {
  @Override
  protected void doGet(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    resp.setContentType("text/html;charset=UTF-8");
    resp.getWriter().write("Hello from Servlet!");
  }
}
Servlet 的映射逻辑、类加载路径、IDE 打包行为,这三块叠在一起最容易出无声故障。很多人卡住不是因为不会写代码,而是没意识到 Tomcat 查找 class 和匹配 URL 的过程是分阶段、有优先级的 —— 比如先看 web.xml,再查注解,再 fallback 到默认 servlet,每一步断在哪,表现出来的现象都不同。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

117

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

173

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

99

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

170

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

200

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

169

2024.02.23

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.3万人学习

Java 教程
Java 教程

共578课时 | 82万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号