配置SSL信任库后微服务Tomcat 9001端口启动失败求助

1. 排查信任库路径与权限 #

• 核对truststore配置的路径：如果信任库放在项目src/main/resources下，路径要写成classpath:xxx.jks；如果是外部文件，必须用绝对路径，避免相对路径导致找不到文件。
• 检查文件权限：Linux环境下，运行服务的用户必须有信任库文件的读权限，可通过chmod 644 your-truststore.jks调整权限。

2. 验证信任库密码与类型 #

• 确认truststore-password和服务端证书库的key-store-password和生成证书时的密码完全一致，密码是大小写敏感的，别输错。
• 检查truststore-type：如果是PKCS12格式的证书，必须指定为PKCS12，默认的JKS格式不兼容PKCS12证书，会直接导致加载失败。

3. 检查信任库文件有效性 #

• 用keytool命令验证：执行keytool -list -keystore your-truststore.jks，输入密码后能正常列出证书信息，说明文件没问题；如果报错，要么密码错了，要么文件损坏，得重新生成或修复证书。
• 确保证书格式兼容：Tomcat只认JKS、PKCS12这类格式，PEM格式的证书要先转换成JKS或PKCS12再用。

4. 排查端口与配置冲突 #

• 检查9001端口是否被占用：Windows用netstat -ano | findstr :9001，Linux用lsof -i :9001，如果被占用就换个端口或者停掉占用的进程。
• 避免重复SSL配置：如果代码里用@Bean手动配置了Tomcat Connector，又在application.yml里加了SSL配置，会导致冲突，只能保留一种配置方式。

5. 核对JDK版本兼容性 #

• 要是用的PKCS12格式证书，JDK版本得在1.8u101以上，旧版本JDK对PKCS12支持不好，直接升级到JDK11+能避免这类问题。

参考配置示例 #

server:
  port: 9001
  ssl:
    enabled: true
    key-store: classpath:server-cert.jks
    key-store-password: your-server-pass
    key-store-type: JKS
    trust-store: classpath:trust-store.jks
    trust-store-password: your-trust-pass
    trust-store-type: JKS
    client-auth: need  # 根据业务需求选want/need/none

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