用 AI 写完了小程序代码,为什么还是上不了线?代码之外的坑才是真门槛
- 2026-10-28 08:23:03
上一期《不会代码能做微信小程序吗？我用 WorkBuddy 从零跑通了一遍》我用 WorkBuddy 把“家用维修记事本”这个小程序从零跑通了。27 个文件 AI 写完、数据库建了集合，最后在真机上扫码验证过，确实能跑。到这一步，很多人以为“大功告成”，最难啃的骨头啃完了。
我当初也是这么想的。结果卡了半天才真正上架。为什么？
问题不在代码。卡的是另一串东西：合法域名、审核备案、密钥安全，还有微信登录和云环境。这些没有一个需要你写代码，但缺任何一个，用户手机上就看不到你的小程序。
不过这串坑不是每个项目都全中。合法域名只在你有自己的服务器（自建后端）时才要操心；走微信云开发、数据走微信自己的通道，这一环直接免掉。但审核备案和密钥安全，不管你用哪种架构都绕不开。
这篇文章专讲这“代码之外的那一串”。我把踩过的坑和结论摆给你，你照着提前排雷就行。
为什么“写完了”还是上不了线：加法错觉 vs 乘法现实
先点破一个常见错觉。很多人觉得上线是“加法”：代码写完了，再补点功能、调调样式，就能上线。按这个想法，AI 把代码这环压薄了，上线应该也变容易。
代码写完后，一定要测试，所有测试没有问题了才走备案等接下来的环节，否则上线了用户体验不好，一样是个失败的作品。
现实是“乘法”。上线的每个环节是一个因子，它们乘在一起，不是加起来。代码质量、合法域名、审核备案、密钥安全、登录云环境，每个都是因子（合法域名看架构，云开发免、自建后端才要，下文会拆）。只要有一个是 0，乘积就是 0，小程序上不了线，手机上看不到。
代码之外的那一整串，逐环拆解
每一步单独就能卡死你，而且都有真踩过的坑。现在虽然开发容易了，但上架环节一个没少，而且还需要自己亲手操作。
合法域名：本地能调，线上失联
合法域名（服务器域名白名单）只在一种情况下是硬门槛：你的小程序客户端用 wx.request 直接连你自己的或第三方的 HTTP 服务器。这时候微信强制你把域名登记进“开发管理 → 开发设置 → 服务器域名”，没登记的线上一律拒掉。反过来，走微信云开发（云函数 + 云数据库）的项目，客户端请求走微信自己的通道，不经过你的服务器，这一环直接免掉。开发者工具默认勾了“不校验合法域名”，本地怎么调都正常，一上真机就白屏，这个坑专坑“自建后端”的人。
Tips：合法域名是“客户端连你自己的服务器”才需要的白名单；纯云开发（云函数 + 云数据库）免合法域名。
最隐蔽的坑之一，也是我踩过的真事。我 2026 年 5 月发过一篇“上传后无数据”的亲历，那会儿走的就是自建后端：本地开发者工具里数据好好的，一发布到线上，页面打开是白屏，请求全失败。原因就一个：没配“合法域名”，线上环境强制校验，没登记过的域名一律拒绝。
如果你的后端是自建的，就必须配置白名单，否则小程序就会出现白屏。
审核 / 备案 / 注册：第一道坎就劝退一半人
上线前要过注册、类目、审核、备案。每一道都有自己的雷。
注册就有坑 - 注册其实是在开发小程序之前的步骤。我整理过一份坑清单：
1.用常用邮箱注册会提示已被占用，得用全新邮箱 - 没有注册过微信平台，这一点非常严格；
2.主体类型选成企业就改不回个人，只能注销重来；
3.激活邮件收不到得翻垃圾箱；
4.同一张身份证个人主体小程序上限 5 个，注销过也占名额；
5.账号类型选错一天只能注册一次。
类目是另一个雷区。小程序选类目不是随便挑，官方有份《小程序备案服务内容标识选择指引》。拿“家用维修记事本”说，它逐条比对两个类目，最后靠一个词分家：“在线预约”。带预约、派单、接单、上门的，归“生活服务-家政”，个人主体做不了；只是把修完的事记下来，归“工具-备忘录”，个人可做。名字里带“家修”这种维修语义热词，审核员可能往“家政”上靠，得靠简介第一句兜底，我填的原话是“不提供任何维修上门、预约、接单或交易服务”。
过了类目，还有备案。
入口在微信公众平台后台：左侧“设置”→“基本设置”→“小程序备案”→“去备案”；同一片设置区里还有“用户隐私保护指引”（“设置”→“功能设置”），收集用户信息的小程序也得填。下面三条，前两条我都栽过：
1.备案有 24 小时死线。提交后 1 到 2 天，工信部会从 12381 发来短信。你必须在 24 小时内点短信里的链接完成验证，超时直接驳回、从头再来。手机记得调最大音量、别静音；收到陌生短信先别删，12381 可能被系统归进拦截。
2.核验照片要求很严。纯白背景、免冠、手持身份证、五官清晰、手臂露出来，白墙前拍，别用美颜。这是最常见的驳回原因。
3.类目和简介不能自相矛盾。服务类目保持“工具-备忘录”，简介首句守住不提供服务那条红线，否则审核员照着名字里的“家修”两个字，会怀疑你实际在提供维修服务，一样给你弹回来。
备案还有周期。不是你点提交就立刻生效，走完要等。代码写得再快，也催不了审核员。
AI key 安全：看不见的环，漏了不只是上不了线
密钥这环最容易被忽略，因为它不报错，但后果最重。云开发控制台里有两种 key：客户端用的 Publishable Key，可以放浏览器，只请求公开资源；服务端用的 API Key，页面上那句提醒很重，妥善保管、别跟人共享、也别放进浏览器或客户端代码里。
我 2026 年 7 月发过一篇“零成本免 key AI 客服”的亲历：密钥只在服务端，前端绝不直调。原因就在这：服务端那把 key 一旦落到前端，别人扒开代码就能拿走，你的云资源就被别人动用了，而且不一定能立刻吊销。这一环出现问题，不只是上不了线，是可能出事。
Tips：密钥这事有个朴素但要紧的规矩，能见人的放客户端，动真格的服务端那把，永远不落到前端。这条是云开发平台自己写在配置页上的。
微信登录 / 云环境：上一期已带过
这两环在 X-020 里已经跑通了（挂技能卡、开云服务、扫码绑定）。本文不重复展开。这一步的目的是，你的全部数据在云数据库里，交互的所有云函数也在云环境里，开通不了，你的数据就保存不了，功能就使用不了。
上线前自查清单
上线前把每个环节过一遍，别漏环。我给自己列了一张清单，你直接抄：
· 合法域名配了吗？线上环境登记了几个要用到的域名，不是只本地能调。
· 审核备案过了吗？类目选对了吗，名称简介和功能一致吗，备案走了吗。
· 密钥没漏在前端吧？服务端 key 只在后端，前端只有 Publishable Key。
· 登录云环境绑对了吗？账号是你的，云环境 ID 填的是你自己的。
这张清单的意义：AI 压薄了“写代码”，但没消掉其余环节。代码写完，你才是最后验收的人，不是 AI 说能跑就完事。
常见问题
微信小程序上线必须备案吗？个人和企业有什么不同？
要。凡是面向公众发布的小程序，都走微信的备案流程，审核通过才能正式上线。个人主体能做的类目有限，比如“工具-备忘录”这种自用记录类，开不了微信支付，也不需要营业执照；企业主体能做的类目多，但要营业执照和可能的行业资质。选错主体类型代价大，个人误选企业只能注销重来。我的“家用维修记事本”走个人主体、工具-备忘录类目，0 元就能备。
合法域名到底在哪配、为什么本地能调线上挂？
在微信公众平台“开发管理 → 开发设置 → 服务器域名”里登记。小程序线上环境只允许请求登记过的域名，没登记的会被拒绝。开发者工具默认不校验合法域名，所以本地怎么调都正常，一发布到线上就白屏。这是最隐蔽的坑之一，和写代码无关，纯配置。如果你走的是纯云开发（云函数 + 云数据库），客户端请求走微信通道，这环用不到，可以跳过。
AI 写的小程序，密钥怎么放才安全？
分两种 key。客户端用的 Publishable Key 可以放前端，只请求你授权过的公开资源；服务端用的 API Key 绝不能进前端或客户端代码，只能留在后端，并且妥善保管、不共享。一旦服务端 key 落到前端，别人扒代码就能拿走，可能动用你的云资源，且不一定能立刻吊销。云开发平台把这条规则直接写在配置页上。
AI 开发完小程序后，还有哪些步骤才能在手机上看到？
代码写完只是其中一个因子。要真正到用户手机，还差这几步，按先后大概是：
1.把账号和云环境绑好。登录开发者账号，开通云开发服务，确认环境 ID 填的是你自己的（这一步 Part 1 已经带过）。
2.配合法域名。只有你的小程序客户端直连自己的服务器才要；走纯云开发（云函数 + 云数据库）这环直接免掉。
3.过审核和备案。选对类目（个人能做的是“工具-备忘录”这类），填好用户隐私保护指引，再走备案流程，备案要等周期、还有 24 小时验证死线。
4.管好密钥。服务端那把 API Key 只留在后端，前端只放 Publishable Key，别让它能被人扒走、动用你的云资源。
5.发布到线上，再用真机扫码验证一遍。本地开发者工具里能跑，不等于线上没问题，这一步别省。
把上一段那张自查清单过一遍，比死磕代码更管用。
结尾
用 WorkBuddy 开发出小程序只是第一步，真正费神的是：合法域名、审核备案、密钥安全，还有账号和云环境的绑定。
所以如果你也在用 AI 做小程序，别被“代码写完了”骗到。上线前把那张自查清单过一遍，每个因子都非零，才算真的到用户手机上。
你正在做或打算做的小程序，目前卡在哪一环，是域名、备案，还是密钥？
—— 前端晨话 · 专注前端技术与 AI 编程 ——
需要项目开发服务？私信联系我
