5+ App 离线打包 AppKey 校验始终失败（WX_KEY_EXCEPTION_VALIDAPPKEY）

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

根据知识库，appkey 校验失败（WX_KEY_EXCEPTION_VALIDAPPKEY / -11001）的核心原因是：appid + 应用包名 + 签名 SHA1 三者必须与你在开发者中心申请 AppKey 时填写的信息完全一致。我无法直接查询你后台的绑定记录，但可以按官方排查步骤指导你确认。

请按以下顺序逐一核对（参考 AppKey 配置文档）：

1. 确认 build.gradle 中签名配置已生效
   在主 APP 的 build.gradle 的 android 节点下配置 signingConfigs，并务必将 signingConfig 引用到 buildTypes 的 debug 或 release 中，否则签名不会生效：

   signingConfigs {  
      config {  
          keyAlias '签名别名'  
          keyPassword '签名密码'  
          storeFile file('xxx/xxx/xxx.keystore')  
          storePassword '密码'  
          v1SigningEnabled true  
          v2SigningEnabled true  
      }  
   }  
   
   buildTypes {  
      debug {  
          signingConfig signingConfigs.config  
      }  
      release {  
          signingConfig signingConfigs.config  
      }  
   }  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
   签名信息需要与后台一致，不一致也会导致 appkey 校验失败。

2. 确认 dcloud_control.xml 中的 appid
   检查离线项目中 dcloud_control.xml 文件中的 appid 是否与申请 AppKey 时的 appid（__UNI__1ABA033）一致。

3. 确认离线工程包名
   检测离线项目的包名（com.jigongshi.app.test）是否与申请 AppKey 时填写的包名一致。

4. 对比实际安装包的 SHA1 与后台配置的 SHA1

   • 获取最终打出的 apk 文件的签名 SHA1（不是直接用 keystore 的 SHA1，要确认实际打包产物）。
   • Android 平台的签名证书 SHA1 值应为小写且不包含冒号。
   • 将该 SHA1 与开发者后台配置的 SHA1 对比是否一致。

5. 确认 dcloud_appkey 配置位置
   dcloud_appkey 必须放在 AndroidManifest.xml 的 <application> 节点内：

   <application>  
      <meta-data  
          android:name="dcloud_appkey"  
          android:value="fcad092f266d11ab4613dca2dafdbf1d" />  
   </application>  

   本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

6. AppKey 不区分 debug 和 release
   AppKey 本身不区分模式，但 Android 调试时必须使用申请 AppKey 时所用的证书。如果你在 debug 构建时使用了默认的 debug 证书或其他证书，会导致校验失败。

如果以上全部确认无误仍报错，建议将最终生成的 apk 安装包上传到 ask 社区 提供给官方核查后台授权记录。

相关文档：

• AppKey 配置
• 项目配置都正确怎么还是提示"未配置AppKey或配置错误"？
• AppKey 申请
• build.gradle 配置