启用SSL后Apache Tomcat Server无法启动问题排查

我首次使用Tomcat，正在进行Tomcat加固操作，没有SSL证书但需要启用SSL。

我的server.xml中Connector配置如下：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           Server =""
           redirectPort="8443" 
           SSLEnabled="true" 
           maxThreads="150" 
           scheme="https" 
           secure="true"
           clientAuth="false"             
           sslProtocol="TLSv1.2" 
           sslEnabledProtocols="TLSv1.2,TLSv1.1"
           />

当移除redirectPort="8443"之后的所有配置时，服务器能正常启动，但保留这些配置就无法启动，日志错误提示：

元素类型“Connector”后面必须跟属性规范、“>”或“/>”。

问题原因及修复步骤 #

1. 修正XML语法错误 #

你的配置里Server =""这一行存在语法问题：XML属性名和等号之间不能有空格，必须改成Server=""。这个空格会导致XML解析器无法正确识别属性，直接抛出语法错误。

2. 补充SSL证书必要配置 #

即使没有正式SSL证书，Tomcat也可以通过自签名证书启用HTTPS，但你的配置缺少证书相关的核心属性，修复语法后可能仍会报错。需要添加以下属性：

• keystoreFile：自签名证书文件的路径
• keystorePass：证书文件的访问密码

修复后的完整配置示例 #

建议将HTTPS端口设为标准的8443，同时保留8080作为HTTP端口并配置跳转：

<!-- HTTP端口配置 -->
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           Server=""
           redirectPort="8443"/>

<!-- HTTPS端口配置 -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           connectionTimeout="20000"
           Server=""
           SSLEnabled="true"
           maxThreads="150"
           scheme="https"
           secure="true"
           clientAuth="false"
           sslProtocol="TLS"
           sslEnabledProtocols="TLSv1.2,TLSv1.1"
           keystoreFile="conf/localhost-rsa.jks"
           keystorePass="changeit"/>

说明：

• Tomcat默认在conf目录下自带一个示例自签名证书localhost-rsa.jks，默认密码为changeit，可直接使用。
• 如果需要自定义证书，可通过Java的keytool命令生成：

  keytool -genkey -alias tomcat -keyalg RSA -keystore conf/tomcat.jks
  

  按照提示输入密码和相关信息后，修改配置中的keystoreFile和keystorePass即可。

内容的提问来源于stack exchange，提问作者Jaiylon