签名失败需先查控制台含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 在新系统上会被拒绝安装。正确流程是两步都做：
立即学习“前端免费学习笔记（深入）”；
