版本代码已被使用：解决 Google Play 上传冲突

问题描述

当您尝试将新的应用包上传到 Google Play 控制台时，可能会遇到错误提示："Version code 1 has already been used. Try another version code"（版本代码 1 已被使用，请尝试其他版本代码）。

这个问题的核心在于 Android 应用的版本控制系统。每个应用更新都必须使用比之前所有版本都更高且唯一的版本代码（version code），无论您进行的是主要版本更新、次要更新还是补丁更新。

解决方案

根据您的具体情况，有以下几种解决方法：

情况一：正式发布更新

如果您已经发布了应用并且正在上传新版本，您需要增加版本代码。

Flutter (pubspec.yaml)

version: 2.0.0+2  # +号后的数字需要增加

Android (build.gradle)

defaultConfig {
    applicationId "com.your.app"
    versionCode 2  // 增加此数字
    versionName "2.0.0"
}

React Native (app.json)

{
  "version": "2.0.0",
  "android": {
    "versionCode": 2
  }
}

情况二：删除草稿版本

如果您之前上传过测试版本但未正式发布，这些版本可能以草稿形式保存：

1. 进入 Play 控制台的 发布 部分
2. 选择 应用包资源管理器（App Bundle Explorer）
3. 点击右上角的应用版本下拉菜单
4. 找到冲突的版本并点击 删除应用构建
5. 如果无法直接删除，请从 发布 → 生产 标签页中丢弃相关发布

注意

一旦应用包被关联到任何发布轨道（如内部测试、公开测试或生产），Google 可能不允许直接删除。这种情况下您必须使用更高的版本代码。

版本代码与版本名称的区别

了解这两个概念的区别至关重要：

• 版本代码 (versionCode)：整数，用于系统内部版本识别，每次必须增加
• 版本名称 (versionName)：用户可见的版本标识（如 1.2.3），遵循语义化版本规范

在 Flutter 的 pubspec.yaml 中：

version: 1.2.3+4  # 1.2.3=版本名称，4=版本代码

最佳实践

1. 版本代码管理：每次构建发布版本时都增加版本代码，即使只是小修改
2. 版本命名规范：遵循语义化版本控制（SemVer）原则
3. 构建命令：使用 Flutter 构建命令时指定版本参数：

   flutter build appbundle --build-name=2.0.0 --build-number=2

常见框架的版本配置位置

框架	配置文件位置
Flutter	pubspec.yaml 和 android/app/build.gradle
React Native	android/app/build.gradle 和/或 app.json
原生 Android	app/build.gradle
Expo	app.json 和 android/app/src/main/AndroidManifest.xml
Unreal Engine	项目设置 → Android → APK 打包

故障排除技巧

如果修改版本代码后仍然遇到问题：

1. 检查 android/local.properties 文件中的版本设置
2. 清理项目并重新构建：flutter clean && flutter build appbundle
3. 确保所有配置文件中的版本代码一致
4. 确认没有在其他发布轨道中使用相同的版本代码

专业建议

维护一个版本代码变更日志，确保每次发布都使用正确的递增序列，避免跳过任何数字。

通过正确管理版本代码和版本名称，您可以顺利解决 Google Play 控制台的上传冲突问题，确保应用更新流程顺利进行。