改Connector端口启动失败，大概率因其他Connector仍监听原端口或新端口被占用；需全局搜索并注释不用的Connector，确保端口唯一。
server.xml 里改端口，只动 Connector 的 port 不够
改完 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 :8080或netstat -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 插件或运维脚本部署时容易出这问题。
实操建议：
- 启动时加
-Dcatalina.base=/path/to/your/base，Tomcat 会优先用$CATALINA_BASE/conf/server.xml，而不是$CATALINA_HOME/conf/server.xml - 在
catalina.out日志开头搜Using CATALINA_BASE和Using CATALINA_HOME，确认实际加载路径 - IDE（如 IntelliJ）运行 Tomcat 时，默认会复制一份
server.xml到临时工作目录，直接改源文件没用，得在 IDE 的 Tomcat 配置里指定“Use alternative JRE”或“Override configuration files” - Docker 场景下，确认
VOLUME或mount是否覆盖了 conf 目录，有些镜像把conf设为只读
HTTPS 配置写错一行，浏览器直接报 ERR_SSL_PROTOCOL_ERROR
不是证书导入不对，也不是密钥密码错了——最常见的原因是 Connector 的 protocol 写成 HTTP/1.1 而不是 org.apache.coyote.http11.Http11NioProtocol，或者漏了 SSLEnabled="true"。浏览器连 TCP 握手都完成不了，自然不会弹证书错误，而是协议层直接断开。
实操建议：
- HTTPS
Connector必须同时满足：含SSLEnabled="true"、protocol是org.apache.coyote.http11.Http11NioProtocol（或Http11AprProtocol）、有keystoreFile和keystorePass -
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 到了默认值。
