WSO2 API Manager 2.1.0迁移后证书相关报错排查咨询

Hey，我来帮你一步步拆解这两个问题——先搞定烦人的FileSystemPreferences警告，再深挖BinaryDataReceiver的Socket错误，结合你提到的和Identity Server共用证书的情况来重点排查：

这个警告是Java系统偏好设置的文件锁异常，根源是运行WSO2 APIM的用户对Java默认的偏好存储目录没有足够权限，你可以按以下步骤解决：

• 检查系统偏好目录权限
  Unix系统下Java的System Preferences默认存在/var/lib/java-util-prefs/，先确认运行APIM的用户（比如wso2或root）对这个目录有读写权限：

  ls -ld /var/lib/java-util-prefs/
  

  如果权限不对，修改目录所属用户组或权限：

  # 替换<wso2-user>和<wso2-group>为实际运行APIM的用户/组
  chown -R <wso2-user>:<wso2-group> /var/lib/java-util-prefs/
  # 或者直接调整目录权限
  chmod -R 755 /var/lib/java-util-prefs/
  

• 指定自定义偏好目录（可选）
  不想碰系统目录的话，也可以在APIM的启动脚本wso2server.sh里添加JVM参数，指定自定义的偏好存储路径：
  找到脚本里的JAVA_OPTS配置段，加上：

  -Djava.util.prefs.systemRoot=/path/to/your/custom/prefs -Djava.util.prefs.userRoot=/path/to/your/custom/prefs
  

  记得先创建这个自定义目录，并且给运行APIM的用户读写权限。

这个错误通常和网络连接、证书配置、端口冲突有关，结合你用了IS的证书，重点检查以下几点：

• 验证证书配置的一致性
  既然你和IS共用证书，得确保APIM这边的证书配置完全匹配：
  1. 对比APIM和IS的密钥库/信任库：APIM的证书文件在<APIM_HOME>/repository/resources/security/，IS的在<IS_HOME>/repository/resources/security/，用以下命令查看密钥库内容，确认别名、证书有效期、密码完全一致：

     keytool -list -keystore <APIM_HOME>/repository/resources/security/wso2carbon.jks
     keytool -list -keystore <IS_HOME>/repository/resources/security/wso2carbon.jks
     

  2. 检查APIM的carbon.xml配置（2.1.0版本用这个文件），确认<KeyStore>和<TrustStore>的路径、密码、类型都和IS的配置一致，比如：

     <KeyStore>
         <Location>${carbon.home}/repository/resources/security/wso2carbon.jks</Location>
         <Type>JKS</Type>
         <Password>wso2carbon</Password>
         <KeyPassword>wso2carbon</KeyPassword>
     </KeyStore>
     

• 检查端口占用情况
  BinaryDataReceiver通常和Thrift、消息传递相关的端口有关，APIM默认的7711（Thrift）、9443（HTTPS）等端口如果被IS或其他进程占用，会导致Socket读取错误。用以下命令排查端口：

  # 检查指定端口，比如7711
  netstat -tulpn | grep 7711
  # 或者用lsof
  lsof -i :7711
  

  如果端口冲突，修改APIM的端口偏移：在carbon.xml里设置<Offset>1</Offset>，这样所有默认端口都会加1，避免和IS冲突。
• 查看完整日志定位具体错误
  你提供的日志不完整，建议去<APIM_HOME>/repository/logs/wso2carbon.log找完整的BinaryDataReceiver错误栈，里面会有更详细的信息——比如是证书验证失败、连接超时还是Socket被重置，这能帮你精准定位问题。
• 确认网络和防火墙配置
  如果APIM和IS部署在不同服务器，要确保两台机器之间的网络连通，防火墙没有拦截相关端口（比如9443、7711），可以用telnet <IS_SERVER_IP> 9443测试连接是否正常。

• 清理缓存重启服务：有时候缓存会导致奇怪的问题，先停掉APIM，删除<APIM_HOME>/repository/tmp/和<APIM_HOME>/repository/work/下的所有文件，再重启试试。
• 确认JDK版本：WSO2 APIM 2.1.0只支持JDK 1.8.x，别用JDK11或更高版本，用java -version检查当前版本是否符合要求。

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