Visual Studio Mac部署Xamarin安卓应用提示Keystore签名失败如何解决

一、密钥库隐性问题排查 #

• 验证密钥别名密码与密钥库密码是否一致：多数开发者会将两类密码设置为不同值，但Visual Studio Mac的签名界面默认会复用密钥库密码作为别名密码，哪怕密钥库密码正确，别名密码不符也会触发该报错。你可以通过keytool工具分别验证：
  1. 验证密钥库密码：执行keytool -list -keystore 你的密钥库文件路径.keystore，输入密码后能正常列出别名即证明密钥库密码正确
  2. 验证别名密码：执行keytool -keypasswd -alias 你的密钥别名 -keystore 你的密钥库文件路径.keystore，输入旧密码无报错即证明别名密码正确
• 确认密钥库文件完整性：如果密钥库是跨系统传输、或者用文本模式下载/传输的，可能会出现二进制字段损坏，即便密码破解工具可识别，签名环节也会校验失败。可以从原始备份位置重新复制密钥库，存放在纯英文无特殊字符的路径下重试。
• 排查JDK版本兼容问题：不同JDK版本生成的密钥库格式存在差异，比如JDK 8生成的JKS格式密钥库，在JDK 11+环境中会默认按PKCS12格式校验，会出现密码正确但校验失败的情况。你可以先确认Visual Studio Mac绑定的JDK版本，用对应版本的keytool重新验证密钥库，或者在编译配置中强制指定JDK 8作为安卓编译用JDK。

二、Visual Studio Mac配置问题排查 #

• 核对项目签名配置：Xamarin.Forms安卓项目的Debug、Release配置签名设置是独立的，你需要确认当前编译的Release配置下，选中的密钥库路径、别名与你输入的密码完全匹配，避免VS调用了其他路径下的旧密钥库。也可以直接打开安卓项目的.csproj文件，搜索<AndroidKeyStore>相关配置节点，确认路径、别名配置正确。
• 清除缓存重试：VS Mac本地缓存可能留存错误的密码或旧签名配置，你可以关闭VS后删除项目根目录下的bin、obj文件夹，再删除~/Library/Caches/VisualStudio/目录下对应版本的缓存，重新打开项目输入密码尝试签名。
• 检查文件读取权限：如果密钥库存放在Mac的桌面、文档等受隐私权限限制的目录，VS没有读取权限时也会误报密码错误。你可以把密钥库移动到用户根目录下的自建文件夹，右键文件夹选择「显示简介」，确认当前用户拥有读写权限后，重新选择密钥库重试。

三、临时替代方案 #

如果上述排查都未解决问题，可以跳过VS可视化界面签名，改用原生安卓工具手动签名：

1. 在VS中对项目执行「归档」操作，生成未签名的APK安装包
2. 执行命令签名：jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore 你的密钥库路径.keystore 未签名.apk 你的密钥别名
3. 签名完成后执行对齐操作：zipalign -v 4 已签名.apk 最终上架.apk

内容的提问来源于stack exchange，提问作者Wallace B. McClure