很多开发者第一次发布微信小程序时,都会遇到一个困惑:后台明明显示“审核通过”了,为什么用户在微信里搜不到?或者搜到了,打开还是旧版本?
答案其实涉及两个层面:一是小程序什么时候在平台上线,二是用户什么时候能用上新版本。这两个时间点并不同步。
审核通过后,还需要手动点击“发布”
微信小程序的发布流程分为两个独立步骤:提交代码审核,以及审核通过后手动发布。审核通过只是获得了上线资格,并不会自动发布到线上。
在微信公众平台的“版本管理”页面,审核通过的版本会出现在“审核版本”区域,需要管理员点击“发布”按钮,并扫码确认,小程序才会正式上线。如果审核通过后一直不点击发布,小程序不会出现在用户端。
关于审核本身的时间,常规版本一般为1到7个工作日。代码量小、逻辑简单的版本,最快当天就能出结果;涉及特殊类目或复杂逻辑的,审核时间可能更长。企业认证用户每年有3次加急审核机会,加急审核通常在20分钟左右完成。需要注意的是,审核期间小程序依然可以正常访问旧版本,不会因为提审而中断服务。
用户端生效:24小时内逐步覆盖
点击发布后,小程序开发者后台会显示“发布成功”,但这并不意味着所有用户立刻就能用到新版本。
微信客户端会缓存小程序的代码包,用户下次打开小程序时,客户端会先使用本地缓存的版本,同时在后台检查是否有更新。如果有新版本,会在下一次冷启动时完成更新。也就是说,新版本需要等到用户再次冷启动小程序时才会生效。
全量发布的情况下,24小时之后新版本可以覆盖99%以上的用户。对于设置了“小程序最低可用版本”的场景,可以强制用户更新到指定版本,但普通功能迭代一般不需要这么做。
如果希望让核心用户尽快用上新版本,可以在发布后引导用户手动删除小程序再重新进入,这样会触发一次完整的版本检查。也可以在代码中使用wx.getUpdateManager API,主动提示用户重启更新。
一个容易被忽略的前置条件:备案
如果是新注册的小程序,在发布之前还需要完成小程序备案。自2023年9月起,新开发的小程序必须完成备案才能上架。
备案流程包括平台初审和管局审核两个环节。平台初审通常在1到2个工作日内完成,管局审核则需要1到20个工作日。备案和代码审核可以并行推进,但最终发布动作必须等备案通过后才能执行。
小程序发布后的生效时间,核心看两点:审核通过后是否及时点击了发布,以及用户端更新的缓存机制。后台发布是“秒级”完成的,用户端完全覆盖通常需要24小时。如果发布了但迟迟看不到变化,优先检查是否遗漏了“发布”按钮,再确认小程序是否已完成备案。

