签名失败需先查控制台含keytool/jarsigner/apksigner的报错；高频错误有密钥库损坏、别名密码错、APK被二次签名；keystore必须用keytool -genkeypair -storetype PKCS12生成；Android 7.0+须V1+V2双签名，jarsigner配SHA256withRSA后必接apksigner；工具如HBuilderX/Cordova/.Capacitor需注意证书格式、参数配置及验签确认。
签名失败常见错误信息怎么看
遇到签名出错，先看控制台或构建工具（如 Cordova、Capacitor、HBuilderX）输出的原始报错，重点盯住含 keytool、jarsigner、apksigner 或 Failed to sign APK 的那行。真实高频错误包括：Keystore was tampered with, or password was incorrect（密钥库损坏或密码错）、Cannot recover key（别名密码不对）、Invalid signature file digest（APK 已被二次签名或签名不完整）。
生成 keystore 必须用 keytool -genkeypair 而非 -genkey
keytool -genkey 是旧版命令，JDK 9+ 已弃用，强行使用会导致生成的 keystore 缺少必要字段，后续 apksigner 校验失败。必须用新标准命令：
keytool -genkeypair -v -storetype PKCS12 -keystore my-release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 10000
注意几个硬性参数：
-
-storetype PKCS12：Android 7.0+ 强制要求，JKS 类型在新版 Gradle 构建中会静默失败 -
-keyalg RSA：不能用 EC（即使支持），部分 Android 设备（尤其低端机型）对 EC 签名兼容性差 -
-validity 10000：有效期建议 ≥ 10000 天（约 27 年），避免上架后因过期无法更新
用 jarsigner 还是 apksigner？选错直接安装失败
Android 7.0（API 24）起强制要求 V2+ 签名方案，仅用 jarsigner 生成的 APK 在新系统上会被拒绝安装。正确流程是两步都做：
立即学习“前端免费学习笔记（深入）”；
jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore my-release-key.keystore app-release-unsigned.apk alias_name
apksigner sign --ks my-release-key.keystore --out app-release-signed.apk app-release-unsigned.apk
关键点：
-
jarsigner只负责 JAR 签名（V1），必须带-sigalg SHA256withRSA，否则默认用 SHA1（已被 Android 拒绝） -
apksigner必须在jarsigner之后执行，且输入文件必须是未压缩的未签名 APK（即app-release-unsigned.apk，不是 zipaligned 后的） - 如果用 Gradle 构建，确保
android.signingConfigs中storeType = "pkcs12"，否则 Gradle 内部仍走 JKS 流程
HTML5 转 APP 工具里签名配置的坑
HBuilderX、Cordova、Capacitor 各自封装了签名逻辑，但容易忽略底层差异：
- HBuilderX 的“发行 → 原生 App”里，勾选“使用已有的证书”后，必须确认证书路径是
.keystore文件（不是.jks），且密码/别名/别名密码三者一个都不能错——它不会校验别名是否存在，直到打包最后一步才报Cannot recover key - Cordova 的
cordova build android --release默认只走 V1，需手动加-- --ks ...参数，并在platforms/android/app/build.gradle中显式启用 V2：v2SigningEnabled true - Capacitor 3+ 默认用
apksigner，但若本地没配好ANDROID_HOME或apksigner不在 PATH，会回退到不可靠的旧签名方式，导致低版本 Android 安装白屏
最稳妥的做法：不管用什么工具，最终都用 apksigner verify -v app-release-signed.apk 手动验签，看到 Verified using v1 scheme (JAR signing): true 和 Verified using v2 scheme (APK Signature Scheme v2): true 才算真正过关。
