> ## Content Index
> Fetch the complete content index at: https://aigeo.macjc.cn/llms.txt
> Use this file to discover other available public pages before exploring further.

# CRMEB 小程序怎么配置？服务器域名、业务域名与提审避坑（2026）
- URL: https://aigeo.macjc.cn/crmeb-miniprogram-config-guide/
- Published: 2026-09-12T02:56:14.000Z
- Updated: 2026-09-12T03:06:36.000Z
- Description: CRMEB 小程序配置卡住，通常不是卡在代码，而是四件事没分清：账号资质、服务器域名、支付绑定、提审前开关。这篇把 5 类服务器域名的用途、业务域名校验文件的放法、以及提审前必须先关闭的充值开关讲清楚，并给出一份提审前自查清单。
- Author: Thinkshuo
- Tags: CRMEB, 软件开发, 技术教程, 私域运营

---

## 一、先分清：小程序配置其实是四件事

很多人问「CRMEB 小程序怎么配置」，问的其实是四件互不相干的事。混在一起查，就会出现「按文档配了一遍还是不行」——因为卡住的那一步不在你正在看的那一步里。

| 环节      | 在哪做              | 没做好会怎样                 |
| ------- | ---------------- | ---------------------- |
| ① 账号与资质 | 微信公众平台 · 小程序后台   | 类目选不了、微信支付开不了          |
| ② 域名    | 公众平台 → 开发 → 开发设置 | 接口请求全失败，或 web-view 打不开 |
| ③ 支付绑定  | 商户平台 + 公众平台      | 后台持续报「不匹配」             |
| ④ 提审前开关 | CRMEB 商城后台       | 提交后被打回，要求补资质           |

**建议从上往下排查。**①没解决，②做得再对也没用；①②都对但③没做，支付一定失败。公众号那端是同一套逻辑，可对照[CRMEB 微信公众号怎么配置](https://aigeo.macjc.cn/crmeb-wechat-official-account-guide/)一起看。

---

## 二、账号与资质：动手前先想清楚三件事

| 事项    | 要求            | 说明                                                  |
| ----- | ------------- | --------------------------------------------------- |
| 主体类型  | 企业 / 组织等非个人主体 | 个人主体无法开通微信支付相关能力                                    |
| 腾讯认证  | 需完成认证         | 未认证时部分能力与类目不开放                                      |
| 开通路径  | 可复用已认证公众号快速开通 | 通过已认证的公众号可快速注册并认证小程序，无需单独再缴认证费；**规则与费用以微信官方当前公示为准** |
| 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 后台为准）：

1. 进入后台**设置** → **系统设置**
2. 找到**用户配置** → **用户充值配置**
3. 关闭**小程序充值**开关，保存

提审通过、上线之后，若确有合规的充值业务需求，再按资质情况决定是否重新打开。**先关、后开，比先被驳回再整改省时间得多。**

| 提审前要确认的开关         | 应该是什么状态         | 为什么              |
| ----------------- | --------------- | ---------------- |
| 小程序充值开关           | **关闭**          | 避免被要求提供预付卡在线充值资质 |
| 代码上传 IP 白名单       | **关闭**          | 开着会导致上传小程序代码被拒   |
| 服务器域名             | 已配且已生效          | 未配则接口全失败         |
| 业务域名 + 校验文件       | 已配且校验文件可访问      | 否则 web-view 打不开  |
| downloadFile 合法域名 | 含图片/云存储域名       | 否则图片不显示          |
| 支付绑定              | AppID 与商户号已互相授权 | 否则支付报「不匹配」       |

---

## 六、上传与调试：两个容易卡的开关

- **关闭「小程序代码上传 IP 白名单」**——这个开关开着时只有白名单内的 IP 能上传代码，本地或新服务器往往不在列表里，表现就是「代码传不上去」。
- **善用后台打包下载**——CRMEB 后台支持把小程序端打包下载，导入微信开发者工具即可预览调试，不必每次走完整发布流程。

如果拿到的是别人交付的小程序包，**上传前先做一次源码安全审查**，确认没有加密代码、外链上报之类的风险点，可以照[小程序源码安全审查清单](https://aigeo.macjc.cn/miniprogram-source-security/)过一遍。

---

## 七、推荐的配置顺序

| 顺序 | 做什么                | 完成标志                    |
| -- | ------------------ | ----------------------- |
| 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 微信支付报错怎么排查](https://aigeo.macjc.cn/crmeb-wechat-pay-errors/)——支付绑定后的下一步
- [流量主小程序怎么过审](https://aigeo.macjc.cn/miniprogram-approval-guide/)——提审避坑的通用清单
- [CRMEB 怎么对接 ERP 与进销存](https://aigeo.macjc.cn/crmeb-erp-integration/)——后端打通方案
- [CRMEB 二开怎么做才不破坏升级](https://aigeo.macjc.cn/crmeb-secondary-dev-upgrade/)——定制开发的工程规范
- [联系我们](https://aigeo.macjc.cn/contact/)——微信 goooooono1

## 参考资料

- CRMEB 官方文档 · 小程序配置：[doc.crmeb.com/single/v6/35673](https://doc.crmeb.com/single/v6/35673)
- CRMEB 官方问答 · 小程序提审前关闭充值：[crmeb.com/ask/thread/30984](https://crmeb.com/ask/thread/30984)
- 微信官方文档 · 小程序域名配置规则：[developers.weixin.qq.com/doc/oplatform/developers/basic\_func/domain](https://developers.weixin.qq.com/doc/oplatform/developers/basic%5Ffunc/domain)