上架一个小程序,除了代码还需要哪些工作
- 2026-11-23 06:01:20
朋友们早上中午晚上好。
前段时间接触了 mermaid 开源图表插件,萌生了把它做成一个小工具的想法。经过一个月的实践,这个小工具以微信小程序的形态落地并上架使用了,感兴趣的朋友可以微信搜索“小力图表助手”试用。
在这一个月的实践过程中,我先把对 mermaid 开源图表的探索整理成了公众号文章,感兴趣的朋友可以点击链接查看(mermaid开源图表终章:上架免费试用的小程序),而从“能跑的代码”到“能上线的小程序”,中间还隔着备案、证书、审核这一整条链路。本文就以这次实践为示例,把代码之外需要做的事一项一项记录下来,给准备上架小程序的朋友一个参考。
整条链路画出来大概是这样,先看全景,再逐段拆:

一、先分清两类小程序:纯展示,还是有数据交互
动手之前,先判断自己做的是哪一类,这决定了后面要准备多少东西。
第一类是纯展示型。就是一些页面和样式,把内容呈现给用户看,不涉及和用户之间的数据往返,审核发布通过就行,流程最简单。
第二类是有数据交互的。用户在使用过程中产生的数据需要存储,比如用户提交的内容、操作记录、生成结果等。这类小程序就绕不开存储方案,而存储方案有两种选择。
第一种是使用开放平台的云服务方案。它提供认证、存储的全流程托管,接入省心,服务端的事基本不用自己操心。但它对开发账户有资质要求,需要进行企业或个人认证,独立开发者很难通过这个认证,门槛直接卡在这一步。
第二种是把数据存储在自建服务器上。这条路自由度高、成本可控,但服务器的通信接口需要经过 SSL 证书认证,也就是说,你得自己把服务器、域名、证书这一套配齐,才能给小程序提供可用的通信接口。
这次实践走的是第二种。下面的内容,基本就是这条路上的完整流程。
二、自建服务器的第一步:采购云服务器并备案
买了云服务器,不能立刻拿来对外提供服务,第一步是备案。
一般服务厂商都会提供备案操作台,按提示填入服务器信息、责任人主体信息、主要用途,然后提交到厂商初审。初审主要是核查一些必填项有没有填、资料是否齐全,这一步通常很快。
初审完成后,厂商会电话通知到主体人,做一次身份确认,接着提交到管局终审。终审的时间大概一周,整个流程算下来耗时约两周。
这段等待期不用干等。备案通过之前业务跑不通,但代码可以同步写,把两件事并行起来,整体节奏会舒服很多。另外要留意的是,责任人信息里的手机号要保持畅通,厂商核验、管局抽查都可能联系到你,一个漏接的电话就可能让流程多拖几天。
三、第二步:域名备案
有了服务器,还得有域名,因为 SSL 证书是针对域名进行认证发放的。
这一点很关键:服务器上不配置域名的话,就无法挂载 SSL 证书,进而无法给小程序提供通信接口。换句话说,没有域名这一步,后面全部断掉。
购买域名后,在服务厂商的操作台上进行备案,把责任主体信息提交到提供域名的服务厂商备案。域名和服务器如果在同一家厂商,流程会在一个控制台里走完,省去来回切换的麻烦;不在同一家也能办,只是要分别提交资料,多花一点时间。
顺带提醒一句,域名本身要先完成实名认证,实名信息与备案主体保持一致,否则备案提交会被打回。

四、第三步:申请 SSL 证书,配置 nginx
备案完成后,就可以申请 SSL 证书了。
各个厂商都有发行 SSL 证书的服务,但需要收费。其实也可以申请公域 SSL 证书,只要通过验证就行,验证方式是证明这个域名确实归你所有,一般是在域名解析里加一条记录。
这里申请的是 acme 免费证书,流程很简单:从官网或者 GitHub 下载插件到服务器,解压后进入目录,调用工具 acme.sh 配置上申请的域名和证书存储路径,执行申请 SSL 证书的命令。控制台会输出申请的进度,最后输出 success,再验证一下存储路径下确实有证书文件,就说明申请成功了。
免费证书的有效期较短,到期需要续期,acme.sh 支持配置定时任务自动续期,把它们挂上,就不用每隔一段时间手动跑一遍,避免证书过期导致接口突然不可用。
拿到证书之后,在服务器上配置 nginx,把证书信息、服务器 IP 地址、开放的端口都配置进去,重启 nginx。这时在浏览器上能通过域名访问到服务器,就证明配置成功了。
到这里,小程序背后的通信底座算是搭好了:服务器能访问、域名能解析、证书能握手。
五、小程序备案:在微信公众平台再报一次
很多人以为服务器和域名备过案就万事大吉,其实还差一步:在微信公众号平台发布小程序,也需要向管局提交备案。
这是独立的一次备案,主体是这个小程序本身。进入微信公众平台,填写责任主体信息、小程序功能及用途等相关内容并提交,一般备案申请会在一周内审核通过。
填写功能及用途时如实描述就好,写清楚这个小程序解决什么问题、用户怎么使用,审核人员看的是“它是不是做了它声称要做的事”。

六、用户隐私保护指引:授权的边界在哪里
在进行小程序开发时,若涉及到微信用户授权,则需要提交用户隐私保护指引,并且在每次获取授权时如实告知用户,说明收集了什么信息、用来做什么。
其中要注意的是权限的差异。常规的授权,比如昵称、微信 ID、定位、相册读写权限等,责任主体为个人即可获取;而手机号授权,只有非个人开发者主体(如企业、政府、媒体、其他组织等)才能申请开通该权限。
这一条会直接影响产品设计。如果你是以个人身份开发,那就不要在核心流程里依赖手机号登录,否则功能设计得再顺,权限这一关也过不去。提前知道边界,能省掉大量返工。

七、代码提交审核:两个必须避开的坑
一切准备就绪后,才是小程序代码的编写与提交。
开发版本可以随时提交,自己或体验成员扫码就能用;但若要发布正式版本,则需要提交代码进行审核。审核时会有人工进行功能核验,出现明细的功能错误会被驳回。
这里有两点需要特别注意。
第一,提交审核不能太频繁,不然会被封禁。被驳回后不要立刻原样再提,先按驳回意见改完、自己完整走一遍流程,再提交。
第二,不能一打开小程序便要用户授权。需要提供正常的浏览、试用操作界面,让用户先用起来,在必要的时候才进行授权申请。我第一次审核被驳回,原因正是这个:一进页面就弹授权,审核人员连功能都看不到,自然判断不了你在做什么。

满足这个要求,除了能顺利通过审核,还可以提高用户的使用体验——先用后授权,用户对产品的信任是在使用中建立的,而不是在弹窗里。从这一点也能看出,微信官方对这个小程序生态的维护是很用心的。
八、算一笔账:真正花时间的地方
整个流程梳理下来,工作量大致是这样的:准备环境、申请备案、配置各项内容的工作占比 50%,产品设计占比 30%,开发代码的工作占比大概占 20%。
有了 AI 的加持,写代码的速率大大提升了,这一块的占比还在继续压缩。工作量集中在了设计和申请备案这块内容上——设计要想清楚产品怎么用,备案要走完一堆流程、等一堆审核。
所以如果你也准备上架一个小程序,建议把顺序倒过来:先启动备案,让流程先跑起来,再用等待的时间做产品设计和写代码。等备案和审核都下来,代码也刚好写完,一套流程并行下来,节奏会顺很多。
工具已经上架,微信搜索“小力图表助手”或扫描以下二维码即可试用。

前两篇关于 mermaid 的文章也欢迎一起看(mermaid开源图表初探 mermaid图表进阶:基于mermaid打磨自己的第一个产品)。
小结
代码之外的工作,听起来都是“杂事”,但它们决定的恰恰是产品能不能被用户看到。服务器、域名、证书决定了接口通不通,备案决定了小程序能不能上架,审核规范决定了用户第一次打开时的体验。
把这些流程走完一遍之后再看代码,会觉得写代码反而是最确定、最有掌控感的一步:需求清楚、反馈即时、改一行就能看到结果。而备案和审核,需要的是耐心、细心,以及提前把资料准备好。
希望这篇记录能帮到同样在路上的朋友。如果对流程里的某一步有疑问,欢迎在评论区或私信交流。
感谢读到这里,祝你的小程序早日上线。