Alfresco 5.2升级至7.2后出现密钥库初始化失败错误求助

排查与解决步骤 #

• 文件权限问题：Ubuntu下Tomcat运行用户（通常为tomcat或alfresco）无密钥库文件读写权限。Windows与Linux权限机制差异大，直接复制的文件权限不符合要求。
  • 检查密钥库目录（默认ALFRESCO_HOME/keystore）权限：

    ls -l /path/to/alfresco/keystore
    

  • 修复权限，将所有者改为Tomcat运行用户：

    chown -R tomcat:tomcat /path/to/alfresco/keystore
    chmod -R 600 /path/to/alfresco/keystore/*.keystore
    

• 路径配置错误：Alfresco 7.x配置参数与5.2存在差异，检查alfresco-global.properties中密钥库相关配置：
  • 确认以下参数指向正确路径，注意Linux路径区分大小写：

    keystore.location=keystore/ssl.keystore
    keystore.type=JKS
    keystore.password=your-password
    keystore.aliases=ssl
    keystore.ssl.password=your-ssl-password
    truststore.location=keystore/ssl.truststore
    truststore.type=JKS
    truststore.password=your-truststore-password
    

• Java版本兼容性：Alfresco 7.2要求Java 11，5.2多使用Java 8，不同版本对密钥库处理存在差异。
  • 检查当前Java版本：

    java -version
    

  • 切换至官方推荐的OpenJDK 11版本，避免非兼容JDK。
• 密钥库格式不兼容：5.2密钥库可能使用旧加密算法，Java 11无法识别，需重新导入：

  # 创建新空密钥库
  keytool -genkey -alias ssl -keyalg RSA -keystore new-ssl.keystore -storepass your-password -keypass your-ssl-password -dname "CN=localhost, OU=Alfresco, O=Alfresco Software Ltd., L=Maidenhead, ST=UK, C=GB"
  # 从旧密钥库导出证书
  keytool -export -alias ssl -file ssl.cer -keystore old-ssl.keystore -storepass old-password
  # 将证书导入新信任库
  keytool -import -alias ssl -file ssl.cer -keystore new-ssl.truststore -storepass your-truststore-password -noprompt
  

  替换配置文件中的密钥库路径为新生成文件后重启服务。
• Tomcat配置冲突：7.x集成的Tomcat版本与5.2不同，检查server.xml中SSL连接器配置：
  • 确保keystoreFile、keystorePass等参数与alfresco-global.properties一致：

    <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
               maxThreads="150" SSLEnabled="true">
        <SSLHostConfig>
            <Certificate certificateKeystoreFile="${catalina.base}/../keystore/ssl.keystore"
                         type="RSA"
                         certificateKeystorePassword="your-password"/>
        </SSLHostConfig>
    </Connector>
    

验证操作 #

1. 修复后重启Alfresco：

   sudo systemctl restart alfresco
   

2. 查看日志确认错误是否消除：

   tail -f /path/to/tomcat/logs/catalina.out
   

3. 访问Web界面检查是否正常加载。

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