一、小程序对证书的四条要求
1. 必须是公开信任的证书
小程序在建立连接时会校验证书是否由公开信任的签发体系发出。自签名证书、内部自建证书在这里通不过,哪怕装了根也没用——因为校验发生在客户端,不在你能控制的环境里。
2. 协议版本与套件有下限
客户端对连接采用的协议版本有明确下限,过低版本会被拒绝;加密套件同理,一些早年的弱套件已不被接受。这两项与证书本身是两件事,但同在服务端配置里,很多人换完证书却不改协议配置,问题照旧。
判断办法是用外部检测工具看实际协商到的版本与套件,不看配置文件里写了什么。
3. 证书链必须完整
客户端不一定能自动补全中间证书,链不完整的表现是「浏览器能开、小程序打不开」,或者部分机型能开、部分机型不能。这类问题在小程序场景里格外常见,因为服务端往往同时给网站与接口用,网站那边靠着浏览器的自动补全显得正常。
4. 域名要在后台登记且备案一致
小程序只能请求在后台登记过的域名,没登记的请求会被拦下。而登记的前提是域名已完成备案,且备案主体与实际运营主体一致。
这两层是串联的:备案主体不对,域名登记可能被要求整改;域名没登记,证书配得再对也发不出请求。排查「连不上」时,顺序应当是先看后台登记,再看备案,再看证书。
二、验证级别怎么定
1. 只核域名通常够用
小程序的访问入口在客户端内部,访客看不到地址栏,也点不开证书详情。这意味着「证书里有没有单位名称」对访客体验基本没有影响。
从纯技术角度看,只核验域名的证书就能满足连接要求,成本也低。多数以接口为主的小程序项目,用这一档即可。
2. 什么情况下要带主体
三种情况建议往上走一档:小程序涉及交易与个人信息,内部或外部审计需要证书体现明确主体;同一批域名还要给官网、公众号网页等对外入口共用,那些入口需要展示主体;行业监管或合作方合同里对证书类型有约定。
判断依据不是「哪个更安全」,而是「有没有人需要核对主体」。有人要核对,就带上主体;没人核对,省下的投入放在自动化上更实在。
3. 域名形态怎么配
小程序通常不是只用一个域名:接口一个、文件存放一个、可能还有埋点与推送。这些域名如果是同一主域下的一层子域,用一张星号证书就能覆盖,新增子域无需重新申请;如果跨多个独立域,就用带多个名称的一张证书。
要注意两处:星号覆盖不到主域本身,主域也要单独列进去;小程序后台登记的域名与证书里列的名称必须对得上,多一个少一个都会出问题。按业务拆成多张的好处是换证时互不影响,代价是续期次数成倍增加;而小程序入口一旦出问题,表现是功能整体不可用,拆分的隔离收益有限,用一张更省事。
三、主体变更会牵连四样东西
1. 小程序备案
小程序本身在应用后台有备案信息,随主体变更而更新。但要分清一种情形:如果变更涉及统一社会信用代码改变,通常需要先注销原备案,再用新主体重新提交备案,而不是自动继承。
企业更名(主体未变)与主体更换(企业换了)是两件不同的事,前者走变更备案,后者往往要注销重办。这一条容易在变更启动后才被问到,提前弄清能省一两周。
2. 域名备案主体
这是容易被漏掉的一环。小程序主体变了,运营方就是新企业;若域名备案还挂在旧主体名下,两者不一致,后续核查可能被要求整改。
处理方式有两种:把域名备案主体变更为新主体,或者用新主体备案一个新域名并做跳转。前者省事,后者适合域名本身也要换的情形。两条路都要提前排期,备案审核本身需要时间。
3. 证书里的组织信息
只核验域名的证书里没有组织信息,主体变更对它没有影响,这一点是它的一个隐性优势。但若用的是带主体信息的证书,证书里写着原单位名称,主体一变,证书内容与实际运营方就不一致了。
这种不一致不会导致连接失败,却会在审计、对账、合作方核验时暴露。稳妥做法是主体变更完成后按新主体重新签发一张,把旧证书在有效期结束后停用,而不是等到期自然过期。
4. 后台登记的域名与授权文件
业务域名一类的配置往往需要在后台重新校验:取回校验文件放到网站指定目录,或者按指定方式添加记录。主体变更后,这类校验通常要重做一次,因为校验与主体资质绑定。
这一环的坑在于「忘了重做」:域名没变、证书没变,看起来一切照旧,直到某天发起复核才发现校验失效。
四、换证流程怎么排
1. 第一步:摸清现状
先列三份清单:小程序后台登记了哪些域名;这些域名各自用哪张证书、什么时候到期;备案主体分别是谁。三份清单对不上的地方,就是后面要处理的工作量。
这一步不要凭印象。实际盘点时常会发现几个早已不用但仍在登记的域名,以及一张没人记得是谁申请的证书。
2. 第二步:先备后换
主体变更是个不可逆的动作,一旦完成,旧主体的资质材料就不好再用。所以顺序上要先做能做的准备:新主体的资质材料、域名备案的变更申请、新证书的签发(若需要),都尽量在变更前启动或完成。
能提前做的做完,变更之后只剩「换装」这一步,窗口就短得多。
3. 第三步:按顺序改四处
变更完成后,按依赖关系改:先备案(小程序备案与域名备案),再后台域名登记与校验,再证书,末了是服务端配置。
顺序不能乱。备案没下来就去改后台登记,可能被要求补材料;证书先换了但后台域名没对上,排查时会误判成证书问题。
4. 第四步:真机验证
后台显示通过不等于用户能用。要在真机上走一遍完整路径:打开小程序、登录、拉取数据、上传文件、支付(若有)。每一步都要看到实际结果,不看日志里的「成功」。
五、时间怎么安排
1. 倒排的四个节点
以变更完成为零点倒排:零点前完成新主体材料与公证件;零点前完成域名备案变更申请;零点前确认新证书已签发并可部署;零点后一周内完成验证与收尾。四个节点写在计划里,谁负责、什么时间点,写清楚。
2. 审核与公证的耗时
主体变更本身耗时主要在公证与审核两段,走线上公证通常当天出证,线下要按周算;官方审核一般半个工作日内出结果。备案环节的耗时取决于各地受理节奏,通常要按周预留。
把这些时间叠加起来,一次带域名的变更,从启动到完全收尾,按两到三周排比较稳妥。
3. 为什么要留缓冲
三个原因:材料被退回需要补正;备案审核有排队;证书签发在某些核验级别下要几个工作日。任何一项卡住,后面的动作都要顺延。
六、切换后要验的六项
1. 真机连通
用不同系统、不同版本的客户端各试一次。链不完整这类问题,往往只在部分机型上出现。
2. 后台校验状态
确认域名登记与校验文件的状态都是通过,而不是「待校验」或「已失效」。
3. 证书链完整
从外部发起连接,确认服务端下发了中间证书,顺序正确,且下发的证书确实是新签发的那一张。
4. 旧域名与跳转
如果换了域名,确认旧域名的跳转仍然有效,且跳转目标是已登记的新域名。跳转链路上任何一环没登记,都会被拦。
5. 支付与登录
涉及支付与登录的链路单独走一遍。这部分通常还绑着商户号与第三方授权,主体变更后需要重新绑定,与证书是两件事,但都在同一次切换里要处理。
6. 到期预警
末了确认一件事:新证书的到期提醒有人收、自动续期能跑通。有效期越来越短,这一条比选哪一档证书更要紧。
结语
小程序的证书选择,技术门槛不高,麻烦在牵连。四条要求——公开信任的证书、协议版本达标、链完整、域名登记与备案一致——决定了「能不能连上」;主体变更牵连的四样东西——小程序备案、域名备案、证书里的组织信息、后台域名与校验——决定了「换完之后还能不能连上」。
落地建议:先按四档把四条要求逐项对齐,确认现有配置;再列三份清单,把域名、证书、备案主体对上;若近期有主体变更计划,按倒排的四个节点提前启动,别把技术动作挤在变更后。做完这些,判断是否到位有个很实在的标准:随便找一台没用过的手机,打开小程序走完一条主流程,全程不需人工干预。