Tomcat 是一个广泛使用的开源 Java Web 应用服务器，支持 HTTPS（HTTP over SSL/TLS）配置，以确保数据传输的安全性，在配置和使用过程中，可能会遇到各种报错问题，本文将从多个角度全面分析 Tomcat 配置 HTTPS 时常见的报错原因及解决方法，并提供相关示例和问答。
Tomcat HTTPS 配置
Tomcat 通过server.xml 文件中的<Connector> 元素来配置 HTTPS，以下是一个简单的 HTTPS 配置示例：
- <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
- maxThreads="200" scheme="https" secure="true" SSLEnabled="true"
- keystoreFile="path/to/keystore" keystorePass="changeit"
- clientAuth="false" sslProtocol="TLS"/>
常见报错及解决方法
1. 404 Not Found 错误
原因分析：
SSL 证书不正确或过期。
Tomcat 配置文件中的 Connector 参数配置错误。
防火墙设置阻止了 HTTPS 请求。
解决方法：
检查 SSL 证书：确保证书正确且未过期，可以使用keytool 命令生成或导入证书。
- keytool genkey alias tomcat keyalg RSA keystore D:/keys/wsriakey.keystore validity 36500
检查 Connector 配置：确保protocol、port、keystoreFile、keystorePass 等参数正确配置。
检查防火墙设置：确保防火墙允许 HTTPS 端口（如 8443）的通信。
2. 无法找到匹配的属性错误
原因分析：
server.xml 文件中的某些属性未正确设置或拼写错误。
解决方法：
检查属性名称和值：确保所有属性名称和值都正确无误。keystoreFile 和keystorePass 属性必须正确指定证书文件路径和密码。
3. SSLHandshakeException 错误
原因分析：
客户端和服务器之间的 SSL/TLS 协议版本不匹配。
客户端不信任服务器的证书。
解决方法：
调整 SSL 协议版本：确保服务器和客户端使用兼容的 SSL/TLS 协议版本，可以在server.xml 中通过sslProtocol 属性指定协议版本，如TLSv1.2。
导入服务器证书到客户端信任库：将服务器证书导入到客户端的信任库中，以解决客户端不信任服务器证书的问题。
4. requires the APR/native library which is not available 错误
原因分析：
Tomcat 尝试使用 APR（apache Portable Runtime）库来处理 HTTPS，但该库未安装或不可用。
解决方法：
使用 NIO 连接器：如果不需要 APR 提供的性能优势，可以改用 NIO 连接器，注释掉 APR 相关的配置，并启用 NIO 连接器。
- <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" ... />
配置示例详解
以下是一个详细的 Tomcat HTTPS 配置示例，包括强制 HTTPS 访问的配置：
- <!server.xml >
- <Connector port="80" protocol="HTTP/1.1"
- connectionTimeout="20000"
- redirectPort="8443" />
- <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
- maxThreads="200" scheme="https" secure="true" SSLEnabled="true"
- keystoreFile="D:/keys/tomcat.keystore" keystorePass="changeit"
- clientAuth="false" sslProtocol="TLS" />
- <!web.xml >
- <loginconfig>
- <authmethod>CLIENTCERT</authmethod>
- <realmname>Client Cert Usersonly Area</realmname>
- </loginconfig>
- <securityconstraint>
- <webresourcecollection>
- <webresourcename>SSL</webresourcename>
- <urlpattern>/*</urlpattern>
- </webresourcecollection>
- <userdataconstraint>
- <transportguarantee>CONFIDENTIAL</transportguarantee>
- </userdataconstraint>
- </securityconstraint>
FAQs
Q1: Tomcat 配置 HTTPS 后，为什么浏览器仍然显示“此网站无法提供安全连接”？
A1: 这个错误通常是由于 SSL 证书未正确配置或不被客户端信任导致的，请按照以下步骤排查：
确保 SSL 证书正确且有效。
确保server.xml 中的keystoreFile 和keystorePass 属性正确指向证书文件和密码。
如果使用的是自签名证书，需要在浏览器中导入该证书并将其标记为受信任。
Q2: Tomcat 启动时出现“requires the APR/native library which is not available”错误，如何解决？
A2: 这个错误表示 Tomcat 尝试使用 APR 库来处理 HTTPS，但该库未安装或不可用，可以采取以下措施解决：
如果不需要 APR 提供的性能优势，可以改用 NIO 连接器，并确保在server.xml 中正确配置 NIO 连接器。
如果需要使用 APR，请确保已安装 APR 库，并在setenv.bat（Windows）或setenv.sh（Linux）脚本中正确设置APR_HOME 环境变量。
通过以上分析和示例，相信您已经对 Tomcat 配置 HTTPS 时的常见报错有了更深入的了解，并能有效地解决这些问题，如果在实际应用中遇到其他问题，建议查阅官方文档或寻求社区帮助。
