几乎每个 Android 开发者在往 Google Play 管理中心(Play Console)传第二个包时,都会撞上这条报错。在步骤 1 — 创建发布版本页面,刚把新打好的 .aab 拖进 app bundle 上传框,下方立刻跳出红字:
已有版本使用了版本代码“<X>”。请尝试改用其他版本代码。
(部分旧版界面显示为 版本代码<X>已被使用。尝试另一个版本代码。;如果通过 Fastlane、GitHub Actions 等发布 API 上传,返回的英文报错则是 APK specifies a version code that has already been used.。)
之所以连踩坑,是因为 Play 管理中心有两条和直觉相反的规则:
versionCode不等于versionName。只把展示给用户的版本号从1.0.0改成1.0.1没有任何作用——Play 管理中心只认正整数versionCode(1、2、3……)来区分每一次构建。- 任何上传过的
.aab都会永久占用该versionCode。只要软件包上传成功,这个整数在当前应用下就永远不能再次上传——哪怕你当时点了「舍弃草稿版本」根本没有发布,或者之前只是传到了内部测试轨道。
先别急着改配置重新打包——先看你有没有改过代码,两种情况的处理方式完全不同。
1没改代码?直接点「从内容库添加」,不要重复上传文件
如果你属于下面这两种情况,完全不需要改 versionCode 重新打包:
- 同一个包已经在内部测试测完了,现在想原封不动发到封闭式测试或正式版。
- 刚才上传过
.aab,中途点了舍弃草稿版本(或不小心关掉了网页),现在想用同一个包重新创建发布版本。
这时候把本地电脑里的同一个 .aab 再拖进上传框,后台一定会报版本代码已被使用——因为这个包已经躺在后台的内容库里了。正确做法是:
- 进入目标轨道(例如 测试和发布 > 测试 > 封闭式测试),点击创建新的发布版本。
- 在 app bundle 区域里,不要点上传,直接点击旁边的从内容库添加(Add from library)。
- 在弹出的列表里勾选刚才已经传上去的那个包(
versionCode <X>)并添加到当前发布版本。 - 填好版本说明,点下一步进入预览并确认即可正常发布。
2改了代码?在对应框架里把整数 versionCode 加 1
只要你修了 Bug、改了 AndroidManifest.xml 权限或更新了依赖重新打包,就必须在打包前把整数 versionCode 至少 +1。
Android Studio / 原生 Gradle
打开 app/build.gradle.kts(或 app/build.gradle),调高 defaultConfig 里的 versionCode:
android {
defaultConfig {
applicationId = "com.yourbrand.app"
minSdk = 24
targetSdk = 35
versionCode = 2 // 每次新打包上传都必须递增的正整数
versionName = "1.0.1" // 商店展示版本号,改不改都不影响后台判重
}
}
(如果是 Groovy 语法的 app/build.gradle,去掉等号写成 versionCode 2 和 versionName "1.0.1" 即可。)
Flutter
Flutter 在 pubspec.yaml 的 version 字段里用 + 号把两个版本号连在一起——+ 号前面是 versionName,+ 号后面的整数才是 Android 的 versionCode:
# pubspec.yaml
version: 1.0.1+2
保存后运行 flutter build appbundle --release 重新打包;如果在 CI 里自动构建,也可以不改文件直接传参覆盖:
flutter build appbundle --release --build-name=1.0.1 --build-number=2
如果改完 +2 上传还是提示版本代码 1 已被使用,打开 android/app/build.gradle(.kts) 检查一下是不是把默认的 versionCode = flutter.versionCode 手写死成了 1。
Expo / React Native
使用 EAS Build 云端打包时,最省心的做法是在 eas.json 里配置远程自增,让 EAS 服务器每次打包自动把 versionCode 加 1,避免本地漏改:
{
"cli": {
"appVersionSource": "remote"
},
"build": {
"production": {
"autoIncrement": true
}
}
}
如果习惯在本地代码里手动管理版本号,打包前把 app.json 里的 expo.android.versionCode 加 1 即可:
{
"expo": {
"version": "1.0.1",
"android": {
"versionCode": 2
}
}
}
(纯 React Native 裸工程没有 app.json,直接按上面 Android Studio 的方式修改 android/app/build.gradle 中的 versionCode。)
Unity
依次打开菜单 Edit > Project Settings > Player,切到 Android 标签页并展开 Other Settings。在 Identification 下方,Version(如 1.0.1)对应展示版本号 versionName,而 Bundle Version Code(如 2)才是整数 versionCode。把 Bundle Version Code 加 1,确认勾选 Build App Bundle (Google Play) 后重新导出即可。
3忘了已经用到几号?去「最新版本和 app bundle」一眼查清
如果之前舍弃过几次草稿,或者在内部测试、CI 里传过好几轮构建,很容易记不清下一个可用整数到底该填几。
打开 Play 管理中心左侧菜单的 测试和发布 > 最新版本和 app bundle(或切到 App bundle 资源管理器标签页),这里会完整列出该应用历史上传过的每一个 .aab——不管是挂在内部测试、已暂停的轨道,还是早就被舍弃的草稿版本都在里面。看一眼列表最上方最大的版本代码,把下一次打包设成「最大数字 + 1」就稳过了(跳号也完全合法,比如直接从 3 跳到 10)。
4关联报错:「不允许任何现有用户升级到新添加的应用程序包」
有时候 versionCode 没有重复,但在点下一步进入预览并确认时,会被另一条和版本号顺序直接相关的报错拦下:
您无法推出此版本,因为它不允许任何现有用户升级到新添加的应用程序包
(在新版界面中也常显示为:此版本未允许任何现有用户升级至新添加的 app bundle,因此无法发布。)
这叫版本覆盖异常(Version Shadowing),通常由以下三种操作引起:
- 从内容库选了旧包:当前轨道在架版本已经是
versionCode 5,你却点从内容库添加选了versionCode 3或4。Google Play 不允许测试或正式轨道上的用户降级。 - 没加新包就直接点下一步:点了创建新的发布版本,但 app bundle 框里什么新包都没加就直接去预览。
- 新包缩窄了设备兼容范围:虽然
versionCode更大,但新包调高了minSdkVersion、删掉了arm64-v8a架构,或新增了严苛的<uses-feature>硬件要求,导致原本在架版本的老设备全都无法升级。
解决办法很简单:核对页面上上一版本(Previous release)显示的在架 versionCode,确保新添加的 .aab 拥有严格大于它的 versionCode 且兼容原有设备,同时把当前草稿里低版本的旧包移除。
14 天封闭式测试里,为什么要多发几个 versionCode?
如果你在预览并确认页面还碰到了 16 KB 内存页面大小对齐、AD_ID 广告 ID 权限冲突,或是去混淆文件与调试符号两条黄色警告,可以对照总目录 Play 管理中心上传 AAB 报错汇总:常见原因与解决办法 逐项排查。
对于个人开发者账号来说,学会递增 versionCode 发新包不只是为了解报错。在 14 天封闭式测试期间,如果从头到尾只挂着最初的 versionCode 1 一动不动,最后申请正式版发布权限时很难证明你真的根据反馈做过迭代;反过来,在 14 天里针对测试人员提的细节问题实打实推上 3 个以上的新版本(versionCode 2、3、4……),既能在封闭式测试轨道留下清晰的更新记录,也能在问卷第 8 题写出具体的修复内容,大幅降低收到「需要进行更多测试」被拒邮件的概率。
当然,多发几个版本的前提是真有人装在手机上持续打开。在 BetaLobby(完全免费,无付费套餐)里,你可以加入 16 人组队模式并共用同一个 Google 群组,免截图核验真机安装,通过 14 天每日打卡保证每次推上去的新版本都有人真正在手机上打开。