0

0

Tomcat server.xml配置详解 修改Tomcat端口和编码

畫卷琴夢

畫卷琴夢

发布时间:2026-02-20 08:15:11

|

949人浏览过

|

来源于php中文网

原创

改connector端口启动失败,大概率因其他connector仍监听原端口或新端口被占用;需全局搜索并注释不用的connector,确保端口唯一。

tomcat server.xml配置详解 修改tomcat端口和编码

server.xml 里改端口,只动 Connectorport 不够

改完 port 启动失败?大概率是被另一个 Connector 占了新端口,或者没关掉默认的 8080。Tomcat 默认带多个 Connector:HTTP(8080)、AJP(8009),有的还配了 HTTPS(8443)。你只改其中一个,其他还在监听,冲突就来了。

实操建议:

  • 用文本搜索整个 server.xml,找所有 <connector> 开头的块,逐个检查 <code>port 属性
  • 如果只想留一个 HTTP 服务,把不用的 Connector 整行注释掉(别只改 port
  • 改完务必确认没有重复端口,比如两个 Connector 都设成 port="8080"
  • Linux/macOS 下启动前可先执行 lsof -i :8080netstat -tuln | grep 8080 看端口是否真空闲

URL 中文乱码,不是加 URIEncoding="UTF-8" 就万事大吉

URIEncoding="UTF-8" 是必须项,但它只管 GET 请求路径里的中文(比如 /api?name=张三),对 POST 表单、JSON body、文件上传完全无效。很多人加了这行还乱码,就是误以为它能“全局生效”。

实操建议:

  • Connector 标签里必须显式加上 URIEncoding="UTF-8",不写默认是 ISO-8859-1
  • POST 请求体乱码,得靠应用层统一设置请求编码request.setCharacterEncoding("UTF-8"),且必须在读取任何参数前调用
  • Spring Boot 用户注意:server.tomcat.uri-encoding=UTF-8 这个配置只是给内嵌 Tomcat 用的,外置 Tomcat 下这个配置无效,必须改 server.xml
  • 如果用了 Nginx 做反向代理,还要检查 proxy_set_header Host $host; 是否带了端口,某些旧版 Nginx 拼错 Host 可能触发编码 fallback

修改 server.xml 后不生效?先看 Tomcat 是不是在用你改的文件

常见现象:改了 $CATALINA_HOME/conf/server.xml,重启服务却还是老配置。原因往往是 Tomcat 实际加载的是另一个路径下的文件,尤其是 Docker、IDE 插件或运维脚本部署时容易出这问题。

cqcms蓝色通用企业网站源码(带手机端)2.9
cqcms蓝色通用企业网站源码(带手机端)2.9

cqcms通用企业建站介绍 cqcms蓝色通用企业网站源码(带手机端)后台非常简单,一个后台同时管理PC和wap。把图片和文字稍加修改,就可以使用。适合任何企业网站 安装步骤: 1、下载文件,并且解压到网站的根目录,配置好apache/IIS虚拟主机以及伪静态;2、安装网址http://localhost/(localhost为您网址地址)3、网站后台入口 http://localhost/ad

下载

实操建议:

  • 启动时加 -Dcatalina.base=/path/to/your/base,Tomcat 会优先用 $CATALINA_BASE/conf/server.xml,而不是 $CATALINA_HOME/conf/server.xml
  • catalina.out 日志开头搜 Using CATALINA_BASEUsing CATALINA_HOME,确认实际加载路径
  • IDE(如 IntelliJ)运行 Tomcat 时,默认会复制一份 server.xml 到临时工作目录,直接改源文件没用,得在 IDE 的 Tomcat 配置里指定“Use alternative JRE”或“Override configuration files”
  • Docker 场景下,确认 VOLUMEmount 是否覆盖了 conf 目录,有些镜像把 conf 设为只读

HTTPS 配置写错一行,浏览器直接报 ERR_SSL_PROTOCOL_ERROR

不是证书导入不对,也不是密钥密码错了——最常见的原因是 Connectorprotocol 写成 HTTP/1.1 而不是 org.apache.coyote.http11.Http11NioProtocol,或者漏了 SSLEnabled="true"。浏览器连 TCP 握手都完成不了,自然不会弹证书错误,而是协议层直接断开。

实操建议:

  • HTTPS Connector 必须同时满足:含 SSLEnabled="true"protocolorg.apache.coyote.http11.Http11NioProtocol(或 Http11AprProtocol)、有 keystoreFilekeystorePass
  • keystoreFile 路径必须是绝对路径,相对路径从 $CATALINA_BASE 解析,很容易找不到
  • Java 17+ 默认禁用 TLSv1.1,若客户端老旧(如某些 IoT 设备),需显式加 sslEnabledProtocols="TLSv1.2,TLSv1.3"
  • 改完 HTTPS 配置后,用 openssl s_client -connect localhost:8443 -servername your.domain 测试,比浏览器更早暴露握手问题

server.xml 是 Tomcat 最底层的开关面板,改一处常牵动多处。最麻烦的不是语法错,而是你以为改了 A,其实 B 组件还在按旧规则跑;或者日志没报错,但某个中间件悄悄 fallback 到了默认值。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

116

2023.10.26

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

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

170

2024.02.23

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

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

98

2024.02.23

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

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

169

2024.02.23

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

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

155

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、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

242

2024.02.23

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

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

167

2024.02.23

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

660

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Rust 教程
Rust 教程

共28课时 | 6.1万人学习

Git 教程
Git 教程

共21课时 | 3.7万人学习

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

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