苹果CMS对接微信小程序全流程配置避坑实操指南

很多人刚碰苹果CMS搭小程序的时候，都卡在对接配置这一步，要么首页黑屏啥都不显示，要么数据拉一半就报错，我前前后后搭了十几个这类小程序，踩的坑能凑个错题本了，今天把实操流程给你们捋明白，照着重来基本不会出问题。

先把前置准备凑齐再动手

别信网上说的啥十分钟就能对接完，纯纯扯淡，你要是第一次搞，先把该有的东西都备齐。首先得有已经搭建完成、能正常访问的苹果CMSV10站点，别找那些到处是bug的破解版源码，后续哭都没地方哭。还有就是注册好的企业主体微信小程序，个人的连资源类服务类目都过不了审，别白费功夫。

小程序的AppID、AppSecret先复制出来存好，后面要用到的地方多了去了。

苹果CMS后台配置调整

地基要打稳，先把CMS这边的配置调好再碰小程序的代码，不然到时候出问题你都不知道该查哪边。

API接口权限开通

进苹果CMS后台，找到系统-网站参数设置-API接口的 tab，先把API状态调成启用，跨域请求头要么填，要么直接填你小程序的合法域名，这步相当于给你家大门配钥匙，没这个权限小程序根本拿不到数据。我之前第一次搞的时候，就忘了开跨域，卡了俩小时还以为是代码错了。

下面的API密钥自己随便设个复杂点的，复制下来存好，后面要填到小程序源码里，别漏字符别输错，我之前就是复制的时候漏了最后一位，死活拉不到数据，对着代码查了仨小时差点砸电脑。

接口可用性测试

调完配置先测接口能不能正常访问，直接在浏览器输下面的地址，能正常返回JSON数据就没问题：

``` // 把域名换成你自己的，正常会返回视频列表数据 https://你的域名/api.php/provide/vod/?ac=list ```

要是打不开要么是伪静态没配置对，要么是服务器防火墙拦截了API请求，先把这个问题解决了再往下走。

微信公众平台后台配置

这步很多人踩坑，测试的时候开了调试模式啥都能用，一上线直接全崩，就是这里没调对。

进微信公众平台，找到开发-开发管理-开发设置，往下滑到服务器域名配置的地方，把你苹果CMS的裸域名（不要http/https前缀，不要带尾巴路径）分别填到request合法域名、downloadFile合法域名、video合法域名里，要是你用了单独的图片CDN或者解析接口，也要一起加进去。

改完域名记得点保存，一般要10分钟左右才会生效，别着急测。还有服务类目记得提前选对，要和你站点的内容匹配，不然上线审核根本过不了。

小程序源码参数修改

现在市面上的苹果CMS配套小程序，基本都有单独的config.js或者global.js配置文件，不用改啥业务代码，直接填参数就行。

打开配置文件，找到对应的配置项，把你刚才存的CMS接口地址、API密钥、小程序AppID依次填进去就行。要是你的CMS后台分类有自定义的，记得把配置里的分类ID和后台的对应上，不然分类页是空的，用户点进去啥都看不到。

本地测试注意事项

打开微信开发者工具导入源码，先把右上角的“不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”选项勾上，先测功能通不通。首页能不能正常刷出资源，播放页能不能正常加载视频，搜索、分类跳转能不能用，用户授权登录能不能正常拿到openid，所有功能跑一遍没问题再说上线的事。

要是出现视频播不了的情况，要么是你CMS的解析接口有问题，要么是小程序的播放器不支持hls格式，换个适配的播放器组件就行，别啥问题都怪对接配置。

上线前的最后检查

所有功能测完了，先把开发者工具的不校验域名选项关了，再跑一遍所有功能，没问题再提交审核。苹果CMS后台的API请求频率可以调高点，不然用户多了直接被拦截，加载半天出不来东西。记得定期备份CMS的数据库和小程序源码，万一出问题能秒恢复，别等数据丢了才后悔。

真碰到啥搞不定的问题，优先看开发者工具的控制台报错，比你瞎猜管用一百倍，基本上90%的问题报错信息里都写的明明白白。