App Store上架全流程踩坑实录：从被拒三次到一次过审

上周五晚上十一点，我盯着电脑屏幕里那封 Apple 审核团队发来的“Your app has been rejected”邮件，差点把键盘砸了。这已经是第三次了——就因为一个隐藏的爬虫功能没写清楚用途，外加一段 Prompt 工程生成的用户引导文案被误判为“诱导性内容”。作为一个每天靠 Cursor 写代码、刷 LeetCode 准备跳槽的云原生老狗，我居然在 iOS 上架这种“基础操作”上栽了跟头，说出去都丢人。

但骂完之后，还是得干活。毕竟下个月就要面试新公司，简历里得有个能上架的 App 才有说服力。于是花了整整三天，把整个 App Store 上架流程从头到尾捋了一遍，顺手整理了这份实战总结。如果你也在边写 K8s Operator 边搞 iOS 项目，这篇绝对能帮你少走弯路。

---

为什么一个后端工程师要折腾 iOS？

先说背景。我在一家中型 SaaS 公司做平台研发，主要搞云原生基础设施，K8s、Helm、Operator 那套玩得挺溜。但最近公司想推一个面向开发者的小工具 App，用于快速查询内部 API 文档和调试接口。产品经理拍板说：“用 Swift 写个原生 App，体验好，还能上 App Store 装 X。”领导一拍大腿：“你不是会写代码吗？顺便搞一下。”

我：？？？

但转念一想，正好可以练手 SwiftUI，顺便给跳槽简历加点“全栈”色彩。于是用 Cursor 搭了个 MVP，核心功能是：

1. 通过公司内网 Token 认证
2. 展示 OpenAPI 文档（动态加载）
3. 支持一键生成 curl 命令（这里用了点 Prompt 工程技巧）
4. 偷偷加了个小爬虫，用来抓取社区技术博客更新（别问，问就是“资源聚合”）

结果，问题就出在第 4 点和第 3 点。

---

上架前的准备：别以为写完代码就完事了

很多人以为 App Store 上架就是“Archive → Upload → Wait”，天真。Apple 的审核指南厚得像《Kubernetes 权威指南》，而且每年都在变。我第一次提交时，连隐私政策链接都没填，直接被拒。

必备材料清单（血泪版）

项目	说明	我的翻车点
App ID & Bundle ID	在 Apple Developer 后台注册，建议用反向域名格式	一开始用了 com.mycompany.tool，结果和公司其他项目冲突
Provisioning Profile	Development / Distribution 两个都要配	本地跑得好好的，上传后崩溃，才发现签名用错了
隐私政策 URL	必须可公开访问，且内容真实	临时用 GitHub Pages 搭了个静态页，但没写清楚数据收集范围
App Store Connect 元数据	名称、描述、关键词、截图等	截图用了模拟器默认状态栏（显示 9:41），被拒理由：“截图不真实”
审核备注（Review Notes）	极其重要！ 用于解释敏感功能	第一次没写，审核员以为我的爬虫是恶意行为

特别提醒：如果你的 App 用到了网络请求（比如我的文档加载和爬虫），必须在 Info.plist 中声明 NSAppTransportSecurity，否则 iOS 10+ 直接 block 掉 HTTP 请求。别问我怎么知道的。

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>api.yourcompany.com</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
            <true/>
        </dict>
    </dict>
</dict>

---

关于“爬虫”和“资源”的审核雷区

我的 App 里有个小功能：每天凌晨自动抓取几个技术博客（如 Hacker News、Dev.to）的 RSS，聚合到“资源”标签页。初衷是帮开发者快速发现新文章，但 Apple 审核团队显然不这么想。

第一次被拒理由：

“Your app includes hidden or undocumented features that may be used for scraping content without permission.”

翻译：你这玩意儿是不是在偷偷扒别人网站？

当时我一脸懵——RSS 不是公开的吗？后来研究发现，Apple 对“自动化获取第三方内容”非常敏感，尤其是当你的 App 没明确说明数据来源时。

解决方案：

1. 在 App 内显眼位置标注“内容来自公开 RSS 源”
2. 在审核备注中附上每个源的授权证明（比如 RSS 规范本身就算一种“默许”）
3. 最关键：在隐私政策中写明“本 App 仅聚合公开技术资源，不存储用户数据，不用于商业用途”

第二次提交时，我还在设置页加了个“数据来源”按钮，点开能看到所有 RSS 链接和更新时间。这才勉强过关。

---

Prompt 工程：别让 AI 生成的内容害你被拒

我用 Cursor 做了个小功能：用户输入自然语言（比如“查一下用户创建接口”），AI 自动转换成对应的 curl 命令。背后其实是个简单的 Prompt 工程：

let prompt = """
You are a helpful API assistant.
Given the user's query, output ONLY a valid curl command to call the internal API.
Do not explain, do not add markdown, just the command.
User query: \(userInput)
"""

这个设计初衷是好的，但第一次提交时，我在引导文案里写了“试试问‘怎么创建用户’”。结果审核员以为我在诱导用户输入特定内容来触发隐藏功能，直接拒了。

教训：

• App Store 严禁任何“诱导性提示”，尤其是涉及用户输入的场景
• AI 生成的内容必须可解释、可追溯
• 所有 Prompt 模板最好硬编码在客户端，不要动态下发（避免被认定为“远程控制”）

后来我把引导文案改成：“你可以描述你想调用的接口”，并在审核备注中说明：“所有输出均由本地规则生成，无远程 AI 调用”。这才过了。

---

构建与上传：Xcode 的玄学时刻

终于搞定内容合规，到了技术环节。结果 Archive 的时候又出问题——本地跑得好好的，打包后启动闪退。

排查发现是 SwiftUI 的 @State 变量在 Release 模式下初始化顺序异常。解决方法是在 SceneDelegate 里加了个延迟初始化：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    
    // 避免 Release 模式下 State 初始化竞争
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
        window = UIWindow(windowScene: windowScene)
        window?.rootViewController = UIHostingController(rootView: ContentView())
        window?.makeKeyAndVisible()
    }
}

上传时也遇到坑：Xcode Organizer 显示“Uploaded successfully”，但 App Store Connect 里迟迟看不到构建版本。后来发现是 Bundle ID 和 App Store Connect 里注册的不一致（大小写问题！）。Apple 的系统居然不区分大小写，但 Xcode 严格区分。

---

审核沟通：别怕和 Apple 审核员聊天

很多人以为审核是单向的，其实可以回复！我的第三次被拒是因为“隐私政策未明确说明数据用途”。我立刻在回复里贴了更新后的隐私政策链接，并逐条解释：

“Our app does not collect any personal data. The ‘resource’ feature only fetches public RSS feeds from the following domains: [list]. No user input is stored or transmitted.”

不到 6 小时，就收到“Your app has been approved”。

小技巧：

• 回复要简洁、专业、带证据
• 用英文，别机翻
• 别抱怨，别甩锅，只陈述事实

---

最终效果：从被拒到 4.8 分

现在 App 已经上线两周，评分 4.8（感谢同事们刷好评）。虽然下载量不多，但成功跑通了整个流程，还顺手优化了几个 SwiftUI 性能问题（比如用 @StateObject 替代 @ObservedObject 避免重复初始化）。

更重要的是，我把这段经历写进了跳槽简历：“主导从 0 到 1 的 iOS App 开发与 App Store 上架，熟悉 Apple 审核规范与合规设计”。面试官果然问了细节，聊得挺嗨。

---

给同行的几点真心建议

1. 别把上架当最后一步：从第一天写代码起，就要考虑隐私、权限、元数据。比如用 @AppStorage 存用户偏好时，想想是否需要在隐私政策里说明。
2. Prompt 工程不是万能的：AI 生成的内容必须可控、可解释，尤其在 Apple 这种强监管生态里。
3. “资源”类功能要透明：如果你聚合第三方内容，务必标明来源，最好提供关闭选项。
4. 善用审核备注：这是你和审核员唯一能对话的渠道，别浪费。
5. 被拒不可怕，看不懂拒绝理由才可怕：逐字读官方邮件，对照 App Store Review Guidelines。

最后，如果你也在用 Cursor 写代码、边刷题边搞副业，欢迎交流。毕竟在这个卷成麻花的行情里，能多一个上架的 App，简历就多一分底气。

对了，我那个 App 叫 DevPulse，搜一下就能找到。如果看到 bug，别举报，给我留个评论就行 😅