.NET MAUI应用上传Google Play提示签名密钥错误如何解决

核心概念先理清 #

Google Play开启App Signing后存在两类证书，别搞混用途：

• upload_cert.der：对应上传密钥的公钥证书，只有用和这个证书匹配的、持有对应私钥的keystore签出来的AAB/APK，才会被Google Play认可接收
• deployment_cert.der：对应应用最终签名密钥的公钥证书，这个密钥由Google Play持有，用来给最终分发到用户设备的安装包重签名，本地签名完全用不上，不需要配置。

你之前生成的签名keystore指纹和平台要求不匹配，本质是你本地用来签名的keystore，没有在Google Play控制台登记为合法的上传密钥。

具体操作步骤 #

1. 准备合法的上传签名keystore

   注意：你从控制台下载的.der格式文件是公钥证书，不包含签名必需的私钥，无法直接用来给安装包签名。

   • 如果是新建应用时选择由Google生成上传密钥，需要从控制台下载包含私钥的上传密钥压缩包，从中提取出可用的jks/keystore格式签名文件
   • 如果是原有上传密钥丢失申请重置，需要你本地先生成一个新的jks keystore，按照控制台指引把这个新keystore的公钥证书上传提交审核，审核生效后这个新keystore就是合法的上传签名文件

2. 存放keystore文件
   把准备好的上传keystore放到你.NET MAUI项目的Android平台目录下，比如新建Platforms/Android/Signing文件夹存放，不要把keystore文件提交到公开代码仓库。
3. 配置签名规则，二选一即可

   方案A：项目文件固定配置（适合本地固定开发环境） #

   打开项目的.csproj文件，找到针对Android Release构建的PropertyGroup节点，添加以下签名配置：

   <AndroidKeyStore>True</AndroidKeyStore>
   <AndroidSigningKeyStore>Platforms\Android\Signing\你的上传keystore文件名.jks</AndroidSigningKeyStore>
   <AndroidSigningKeyAlias>你的keystore对应的密钥别名</AndroidSigningKeyAlias>
   <AndroidSigningKeyPass>你的密钥访问密码</AndroidSigningKeyPass>
   <AndroidSigningStorePass>你的keystore存储密码</AndroidSigningStorePass>
   

   方案B：命令行传参构建（更安全，避免密码硬编码） #

   执行dotnet publish命令构建AAB时，直接把签名参数作为命令参数传入，不需要改csproj文件：

   dotnet publish -f net8.0-android -c Release /p:AndroidPackageFormat=aab /p:AndroidKeyStore=true /p:AndroidSigningKeyStore="你的上传keystore文件全路径" /p:AndroidSigningKeyAlias="你的密钥别名" /p:AndroidSigningKeyPass="你的密钥密码" /p:AndroidSigningStorePass="你的keystore存储密码"
   

   注意命令里的net8.0-android要替换成你项目实际使用的.NET版本对应的Android目标框架标记，比如.NET 7对应net7.0-android。
4. 构建前校验
   构建前建议先清空项目的bin、obj文件夹，避免旧版本缓存的签名文件干扰构建结果。
5. 构建后验证签名
   拿到生成的AAB文件后，用JDK自带的keytool工具查看AAB的签名指纹，和控制台「应用完整性」页面里的上传密钥指纹做比对：

   keytool -printcert -jarfile 你生成的aab文件路径.aab
   

   命令输出的SHA1、SHA256值和控制台显示的上传密钥指纹完全一致时，再上传就不会触发签名错误。

常见踩坑 #

• 不要尝试用deployment_cert做本地签名，你拿不到对应私钥，就算配置了也会被平台拒绝
• 不要用默认的debug签名keystore签发布包，debug签名的指纹不可能和上传密钥匹配
• 如果配置后还是提示指纹不匹配，检查csproj里是否存在多个Android Release的PropertyGroup节点，有没有其他签名配置覆盖了你写的规则

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