App Store Connect显示错误Build Number问题求助

这个是大量iOS开发者都遇到过的已知问题，核心触发原因有两类：

• Xcode beta版本编译的构建上传后，App Store Connect会为对应应用生成内部全局递增的构建序列号，切换正式版Xcode上传时，部分场景下后台列表页会优先展示这个内部序列号，而非手动设置的CFBundleVersion（即自定义Build号）
• 切换Xcode正式版时，Xcode默认会自动同步项目的版本配置，如果未手动锁定CURRENT_PROJECT_VERSION配置项，Xcode会自动将其修改为递增的整数，导致上传后的Build号变为整数形式。

验证方法 #

• 打开App Store Connect对应构建的详情页，下拉到通用信息板块，可以同时看到实际上传的自定义Build号和平台内部序列号两个字段，设置的4.8.1、4.8.2都会在自定义Build号字段正常展示，列表页显示的整数是内部递增序列号，完全不影响审核提交的版本号识别。
• 打开Xcode项目的Build Settings，搜索Current Project Version，确认该值是否和预期设置的Build号一致，如果不一致手动修改为需要的语义化版本号即可。

修复步骤 #

• 锁定版本配置：在Xcode的Build Settings中，将Current Project Version和Versioning System设置为手动管理，关闭Automatically increment build number相关选项（若已开启）
• 上传前校验：打包后在Archive界面确认构建的Build号和设置值一致，上传后优先在构建详情页核对自定义Build号字段即可，列表页的整数内部序列号无需处理。
• 若需要列表页优先展示自定义语义化Build号，可以删除后台所有用Xcode beta上传的历史构建，等待24小时后再用正式版Xcode上传新构建即可。

内容的提问来源于stack exchange，提问作者zakray