CRMEB 小程序怎么配置?服务器域名、业务域名与提审避坑(2026)
CRMEB 小程序配置卡住,通常不是卡在代码,而是四件事没分清:账号资质、服务器域名、支付绑定、提审前开关。这篇把 5 类服务器域名的用途、业务域名校验文件的放法、以及提审前必须先关闭的充值开关讲清楚,并给出一份提审前自查清单。
一、先分清:小程序配置其实是四件事
很多人问「CRMEB 小程序怎么配置」,问的其实是四件互不相干的事。混在一起查,就会出现「按文档配了一遍还是不行」——因为卡住的那一步不在你正在看的那一步里。
| 环节 | 在哪做 | 没做好会怎样 |
|---|---|---|
| ① 账号与资质 | 微信公众平台 · 小程序后台 | 类目选不了、微信支付开不了 |
| ② 域名 | 公众平台 → 开发 → 开发设置 | 接口请求全失败,或 web-view 打不开 |
| ③ 支付绑定 | 商户平台 + 公众平台 | 后台持续报「不匹配」 |
| ④ 提审前开关 | CRMEB 商城后台 | 提交后被打回,要求补资质 |
建议从上往下排查。①没解决,②做得再对也没用;①②都对但③没做,支付一定失败。公众号那端是同一套逻辑,可对照CRMEB 微信公众号怎么配置一起看。
二、账号与资质:动手前先想清楚三件事
| 事项 | 要求 | 说明 |
|---|---|---|
| 主体类型 | 企业 / 组织等非个人主体 | 个人主体无法开通微信支付相关能力 |
| 腾讯认证 | 需完成认证 | 未认证时部分能力与类目不开放 |
| 开通路径 | 可复用已认证公众号快速开通 | 通过已认证的公众号可快速注册并认证小程序,无需单独再缴认证费;规则与费用以微信官方当前公示为准 |
| AppID | 小程序有独立 AppID | 认证资质可复用,但应用标识不能复用,别和公众号混用 |
三、服务器域名:5 类域名,各有各的用途
「服务器域名」不是填一个域名就完事,而是按能力分成几类。哪一类没填,对应功能就失败。
| 域名类型 | 对应能力 | 没配的典型表现 |
|---|---|---|
request 合法域名 |
业务接口请求 | 小程序所有接口都失败,页面空白或一直转圈 |
uploadFile 合法域名 |
文件上传 | 上传头像、评价图片、售后凭证失败 |
downloadFile 合法域名 |
文件下载 | 接了云存储时最容易漏:接口通了、数据也回来了,唯独图片空白 |
socket 合法域名 |
WebSocket 长连接 | 在线客服、即时消息连不上 |
udp 合法域名 |
UDP 通信 | 较少用到 |
填写域名时有几条硬要求:
- 必须使用 HTTPS——全站要配好证书
- 不能带端口号——只能走默认的 443
- 不能填 IP 地址——只能填域名
- 域名须已完成 ICP 备案——新备案的域名通常还要等一段时间才能配置
- 不带协议前缀和路径——直接写
wx.example.com这种纯域名形式
四、业务域名:web-view 能不能打开全看它
| 对比项 | 服务器域名 | 业务域名 |
|---|---|---|
| 解决什么问题 | 小程序调接口、传文件 | 小程序内用 web-view 打开网页 |
| 配置位置 | 开发 → 开发设置 → 服务器域名 | 开发 → 开发设置 → 业务域名 |
| 要传校验文件吗 | 不需要 | 需要,且必须能公网访问 |
| CRMEB 场景下的用途 | 商城所有接口 | H5 活动页、协议页、第三方页面 |
业务域名的校验文件,在 CRMEB 这类项目里通常就放在站点的 public/ 目录下。「放上去了」和「能访问到」是两回事——上传完一定要用浏览器实际打开那个地址,确认返回内容正确,再点提交。
另外,域名的可配置数量与每月可修改次数都有上限,具体数值以微信官方当前公示为准。因为有次数限制,建议先把要用的域名一次列全,避免反复试错把额度用完。
五、提审前必须做的第一件事:关掉小程序充值
这是全篇最值得先记住的一条。小程序审核时如果带充值(预付卡)功能,会被要求提供预付卡在线充值相关的经营资质。没有这张资质,功能再正常也会被驳回。
处理路径(以 CRMEB 6.x 后台为准):
- 进入后台设置 → 系统设置
- 找到用户配置 → 用户充值配置
- 关闭小程序充值开关,保存
提审通过、上线之后,若确有合规的充值业务需求,再按资质情况决定是否重新打开。先关、后开,比先被驳回再整改省时间得多。
| 提审前要确认的开关 | 应该是什么状态 | 为什么 |
|---|---|---|
| 小程序充值开关 | 关闭 | 避免被要求提供预付卡在线充值资质 |
| 代码上传 IP 白名单 | 关闭 | 开着会导致上传小程序代码被拒 |
| 服务器域名 | 已配且已生效 | 未配则接口全失败 |
| 业务域名 + 校验文件 | 已配且校验文件可访问 | 否则 web-view 打不开 |
| downloadFile 合法域名 | 含图片/云存储域名 | 否则图片不显示 |
| 支付绑定 | AppID 与商户号已互相授权 | 否则支付报「不匹配」 |
六、上传与调试:两个容易卡的开关
- 关闭「小程序代码上传 IP 白名单」——这个开关开着时只有白名单内的 IP 能上传代码,本地或新服务器往往不在列表里,表现就是「代码传不上去」。
- 善用后台打包下载——CRMEB 后台支持把小程序端打包下载,导入微信开发者工具即可预览调试,不必每次走完整发布流程。
如果拿到的是别人交付的小程序包,上传前先做一次源码安全审查,确认没有加密代码、外链上报之类的风险点,可以照小程序源码安全审查清单过一遍。
七、推荐的配置顺序
| 顺序 | 做什么 | 完成标志 |
|---|---|---|
| 1 | 注册小程序主体并完成认证 | 拿到小程序 AppID 与 AppSecret |
| 2 | 配服务器域名与业务域名 | 校验文件可公网访问 |
| 3 | 与微信支付商户号绑定 | 双方互相授权完成 |
| 4 | 在 CRMEB 后台填微信与支付配置 | 后台不再报错 |
| 5 | 打包 → 开发者工具调试 | 接口、图片、支付全链路可跑通 |
| 6 | 关闭充值开关 → 提交审核 | 审核通过并发布 |
第 3、4 步的顺序不要颠倒。公众号配置里有一条被反复验证的实践经验:先在商城后台把参数填好,再去微信端提交服务器配置;顺序反了会失败,小程序同理。
八、常见问题
Q1:小程序和公众号必须都配吗?
不必须,但建议都配。两者是同一套 CRMEB 后端的两个入口:公众号偏内容传播与老客复购,小程序偏搜索曝光与拉新。
Q2:小程序接口全部失败,先查什么?
先查 request 合法域名是否配了、是否 HTTPS、是否带了端口。如果只有图片不显示,查的是 downloadFile 合法域名。
Q3:web-view 打不开,但接口是通的?
说明服务器域名没问题,问题在业务域名。确认业务域名已配置,且校验文件放在域名根目录、公网可访问。
Q4:域名改不动了是怎么回事?
域名的可修改次数有上限,用完要等下一个周期。建议把要用的域名一次列全再提交,具体上限以微信官方当前公示为准。
Q5:提审为什么被要求提供充值资质?
因为小程序里带了充值(预付卡)功能。提审前先在后台关闭「小程序充值」开关,通过后再按资质情况决定是否开启。
Q6:CRMEB 后台能直接生成小程序包吗?
可以。后台支持打包下载小程序端代码,导入微信开发者工具后用你的 AppID 预览调试。正式发布前,域名与支付配置要按线上环境再核对一遍。
九、服务说明
澄渔工作室提供 CRMEB 二次开发服务:
需求评估、影响面分析、定制开发、联调上线、运维支持。
我们长期在生产环境运维与二开 CRMEB 6.x 体系,覆盖 B2C 与多商户两条产品线,熟悉公众号、小程序、H5 多端配置与微信支付链路;从域名与提审这类环境问题,到分销、分账、系统对接这类业务改造,都可以承接。
案例包括美聚云仓(基于 CRMEB 改造的电商与私域一体化系统)。
微信咨询:goooooono1
延伸阅读
- CRMEB 微信支付报错怎么排查——支付绑定后的下一步
- 流量主小程序怎么过审——提审避坑的通用清单
- CRMEB 怎么对接 ERP 与进销存——后端打通方案
- CRMEB 二开怎么做才不破坏升级——定制开发的工程规范
- 联系我们——微信 goooooono1
参考资料
- CRMEB 官方文档 · 小程序配置:doc.crmeb.com/single/v6/35673
- CRMEB 官方问答 · 小程序提审前关闭充值:crmeb.com/ask/thread/30984
- 微信官方文档 · 小程序域名配置规则:developers.weixin.qq.com/doc/oplatform/developers/basic_func/domain

鄂公网安备42010502001286号