讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

统信UOS怎么解决Tomcat服务访问404或500错误

夏萱吖_4011

夏萱吖_4011

发布时间:2026-11-12 09:25:22

|

718人浏览过

|

来源于php中文网

原创

根本原因是容器内webapps目录为空或Servlet API版本不兼容;若为404且显示Tomcat默认灰色页面,说明请求抵达但无资源,需执行rm -rf webapps && cp -r webapps.dist webapps;若为500并报jakarta.servlet类转换异常,则需降级Tomcat至9.x或升级项目依赖为jakarta.servlet-api。

统信uos怎么解决tomcat服务访问404或500错误

统信UOS中用Docker运行Tomcat后访问http://localhost:8080返回404或500,根本原因常是容器内webapps目录为空、Servlet API版本错配或应用未正确加载——不是端口不通,也不是防火墙拦截,而是Tomcat启动了却没内容可服务。

确认404来源:先看页面长什么样

打开浏览器开发者工具(F12)→ 切到 Network 标签 → 访问 http://localhost:8080 → 点击该请求 → 查看 Response 内容:
如果看到 Tomcat 默认灰色页面,写着 “HTTP Status 404 – Not Found”,说明请求已抵达 Tomcat,但webapps下没有可响应的资源;
如果看到白底红字 “Whitelabel Error Page” 或 “java.lang.ClassCastException: … javax.servlet.Servlet cannot be cast to jakarta.servlet.Servlet”,那就是 Servlet 包版本不兼容导致的 500 错误,必须改依赖。

修复空 webapps 目录(Docker 容器内)

方法一:进入容器手动复制

第一步:运行容器并记录容器ID
sudo docker run -d -p 8080:8080 --name mytomcat tomcat:9

第二步:进入容器内部
sudo docker exec -it mytomcat /bin/bash

第三步:删除空 webapps 并重建
rm -rf webapps && cp -r webapps.dist webapps
【这一步不可跳过,否则ROOT应用永远无法加载】

第四步:退出并验证
按 Ctrl+D 退出容器 → 在宿主机浏览器中刷新 http://localhost:8080 → 应显示 Tomcat 欢迎页。

解决 500 错误:javax 与 jakarta 包冲突

如果你部署的是 Maven 构建的 WAR 包,并在日志里看到类似 ClassCastException: javax.servlet.http.HttpServlet cannot be cast to jakarta.servlet.http.HttpServlet,说明你用了 Tomcat 10+,但项目仍引用 javax.servlet-api。

方法1:降级 Tomcat 镜像(推荐给新手)
停止当前容器:sudo docker stop mytomcat → 删除:sudo docker rm mytomcat → 改用 Tomcat 9:sudo docker run -d -p 8080:8080 --name mytomcat tomcat:9 → 再次执行上一节的 cp -r webapps.dist webapps 步骤。

方法2:升级项目依赖(适用于明确要使用 Tomcat 10+ 的场景)
修改 pom.xml,将所有 javax.servlet 替换为 jakarta.servlet:
删掉:<groupid>javax.servlet</groupid> 及其子项;
加上:<groupid>jakarta.servlet</groupid><artifactid>jakarta.servlet-api</artifactid><version>5.0.0</version>;
重新打包 WAR → 重新部署进 webapps 目录。

验证部署是否生效

进入容器后,执行:ls -l webapps/
应看到至少 ROOT 目录(来自 webapps.dist/ROOT);若部署了自定义 WAR,比如 myapp.war,则解压后应出现同名目录 myapp/。
再执行:tail -n 20 /usr/local/tomcat/logs/catalina.out
看到类似 Deployment of web application directory [/usr/local/tomcat/webapps/ROOT] has finished in [xxx] ms 才算真正加载成功。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

945

2023.10.26

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

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

324

2024.02.23

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

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

509

2024.02.23

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

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

305

2024.02.23

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

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

348

2024.02.23

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

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

349

2024.02.23

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

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

601

2024.02.23

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

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

322

2024.02.23

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Tomcat核心原理解析
Tomcat核心原理解析

共57课时 | 9万人学习

http状态码大全
http状态码大全

共47课时 | 119.2万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn