小程序域名白名单¶
给谁看：申请了微信小程序，准备上架到顾客扫码的店主。
核心：4 行域名，复制粘贴到小程序后台就行。
最小清单（照抄）¶
登录 https://mp.weixin.qq.com → 「开发」→ 「开发设置」→ 「服务器域名」→ 点「修改」，把下面贴进去：
request 合法域名¶
socket 合法域名（店主端实时推送用）¶
uploadFile 合法域名（菜品图片上传用）¶
downloadFile 合法域名（下载 CSV 对账用）¶
4 项都是同一个域名，没填错——都是指向本系统的后端 API。
保存后，你的小程序就能访问本系统了。
几个常见坑¶
| 写错的样子 | 为什么不行 |
|---|---|
api.coffee.aisaasfor.com |
必须带 https:// |
https://api.coffee.aisaasfor.com/v1 |
不能带路径，只到域名 |
https://api.coffee.aisaasfor.com:8443 |
必须 443 端口（默认 HTTPS 端口） |
http://api.coffee.aisaasfor.com |
必须 HTTPS，不能 HTTP |
https://*.aisaasfor.com |
不支持通配符 |
每月最多改 50 次，所以一次加全。
开发调试¶
- 开发版、体验版不校验白名单（微信开发者工具里右上「详情 → 本地设置」勾「不校验合法域名」）
- 正式版严格校验——漏一个，顾客扫码就报
request:fail url not in domain list，而且审核可能直接拒
小程序备案之后，你的小程序主体、域名主体关系¶
- 小程序主体 = 你的公司/个体户
- 域名主体 = 本系统运营方
- 白名单里加的
api.coffee.aisaasfor.com属于本系统运营方，其 ICP 备案由运营方负责 - 你不需要为这个域名做任何备案，直接用即可
如果某天你要换成自己品牌的域名（比如
api.你品牌.com），那就要你自己 ICP 备案 + 小程序白名单里替换成新域名。但这不是必须的，大多数店主就用运营方的域名不用管。