📱 微信小程序配置完全指南
本文档详细介绍微信小程序的基础配置和发货管理配置
📋 目录
💡 前提条件
必需条件
| 要求 | 说明 | 费用 |
|---|---|---|
| ✅ 小程序账号 | 已注册的微信小程序 | 免费 |
| ✅ 企业认证 | 已完成企业认证 | ¥300/年（微信收取） |
| ✅ 微信支付 | 已开通微信支付商户号 | 免费开通 |
| ✅ HTTPS域名 | 已备案的SSL证书域名 | 按需 |
| ✅ 本系统系统 | 已部署并运行 | - |
⚠️ 注意：
1. 小程序必须已完成腾讯认证
2. 必须开通并绑定微信支付商户号
3. 必须配置 HTTPS 域名（SSL证书）注册途径
方式 1：独立注册（推荐）
- 优点：独立账号，权限完整
- 费用：¥300 认证费
- 流程：注册 → 填写资料 → 企业认证
方式 2：公众号快速注册
- 优点：无需再次认证，免费
- 条件：已有已认证的企业服务号
- 流程：公众号后台 → 小程序管理 → 快速注册
🔧 小程序基础配置
步骤 1：登录微信公众平台
访问地址： https://mp.weixin.qq.com
账号说明：
小程序和公众号都在同一平台登录，但账号不同！
请使用小程序注册时的账号登录。步骤 2：完善小程序资料
操作路径： 设置 → 基本设置
必填信息：
| 信息项 | 说明 | 示例 |
|---|---|---|
| 小程序名称 | 2-20个字符 | XX商城 |
| 小程序简介 | 4-120个字符 | 介绍小程序功能 |
| 小程序头像 | 1MB以内，方形 | logo.jpg |
| 服务类目 | 选择经营类目 | 电商平台 → 综合商城 |
⚠️ 注意：
- 小程序名称每年可修改2次
- 服务类目影响可用功能和接口权限
- 头像需要清晰，避免包含营销信息
步骤 3：添加开发者（可选）
操作路径： 管理 → 成员管理 → 项目成员
权限说明：
| 角色 | 权限 | 适用场景 |
|---|---|---|
| 管理员 | 所有权限 | 小程序所有者 |
| 开发者 | 开发、测试权限 | 技术人员 |
| 体验者 | 体验版权限 | 测试人员 |
添加步骤：
- 点击"添加成员"
- 选择角色类型
- 输入微信号
- 对方确认后生效
步骤 4：开发配置
操作路径： 开发 → 开发管理 → 开发设置
4.1 获取 AppID 和 AppSecret
AppID（小程序ID）：
- 直接显示，可以复制
- 格式：
wx开头的18位字符
AppSecret（小程序密钥）：
- 点击"重置"按钮（如首次获取，点击"生成"）
- 管理员扫码确认
- 生成新的 AppSecret
- 立即复制保存（仅显示一次）
⚠️ 安全提示：
AppSecret 仅在生成时显示一次！
务必妥善保管，建议保存到密码管理器。
泄露后请立即重置。4.2 配置服务器域名
操作路径： 开发设置 → 服务器域名 → 修改
需要配置的域名：
| 域名类型 | 用途 | 格式 | 数量 |
|---|---|---|---|
| request合法域名 | API接口请求 | https://api.yourdomain.com | 1-20个 |
| socket合法域名 | WebSocket连接 | wss://ws.yourdomain.com | 可选 |
| uploadFile合法域名 | 文件上传 | https://upload.yourdomain.com | 可选 |
| downloadFile合法域名 | 文件下载 | https://cdn.yourdomain.com | 可选 |
配置要求：
- ✅ 必须使用 HTTPS 协议
- ✅ 域名已备案
- ✅ 已配置有效的SSL证书
- ✅ 每月可修改5次
配置示例：
request合法域名：
https://api.example.com
https://mall.example.com
uploadFile合法域名：
https://upload.example.com说白了： 小程序只能访问你配置的这些域名，其他域名都会被拦截！
4.3 业务域名配置
操作路径： 开发设置 → 业务域名 → 修改
用途： H5页面跳转、web-view组件使用
配置步骤：
- 下载校验文件
- 上传到域名根目录
- 填写业务域名
- 点击保存
示例：
业务域名：
mall.example.com
shop.example.com4.4 关闭IP白名单（重要）
操作路径： 开发设置 → 小程序代码上传
操作：
- 找到"IP白名单"设置
- 选择"关闭"
- 点击保存
为什么要关闭？
IP白名单主要用于限制代码上传的IP地址。
对于本系统系统，不需要生成代码上传密钥，
因此可以关闭此功能，避免限制。步骤 5：消息推送配置（可选）
操作路径： 开发 → 开发设置 → 消息推送
配置参数：
| 参数 | 说明 | 示例 |
|---|---|---|
| URL | 接收消息的服务器地址 | https://api.example.com/wechat/callback |
| Token | 自定义的令牌 | 32位随机字符串 |
| EncodingAESKey | 消息加密密钥 | 43位随机字符串 |
| 消息加密方式 | 推荐"安全模式" | 安全模式（推荐） |
⚠️ 注意： 启用消息推送后，需要服务器响应验证请求。
📦 小程序发货管理配置
为什么需要配置发货管理？
微信要求：
从2022年起，微信要求所有涉及实物商品交易的小程序
必须接入"发货信息管理服务"，否则可能影响小程序审核和使用。功能说明：
- 订单发货后自动同步给微信
- 用户可在微信侧查看物流信息
- 提升用户体验和信任度
步骤 1：开通发货信息管理服务
操作路径： 微信公众平台 → 功能 → 发货信息管理服务
开通步骤：
- 点击"开通"按钮
- 阅读并同意服务协议
- 选择发货方式
发货方式选择：
| 发货方式 | 说明 | 适用场景 |
|---|---|---|
| 物流发货 | 使用快递公司配送 | 实物商品 |
| 同城配送 | 本地配送服务 | 生鲜、外卖 |
| 虚拟发货 | 无需物流 | 虚拟商品、服务 |
推荐配置： 勾选"物流发货"和"虚拟发货"
步骤 2：配置物流公司
操作路径： 发货信息管理服务 → 物流公司管理
常用物流公司：
| 物流公司 | 代码 | 说明 |
|---|---|---|
| 顺丰速运 | SF | 快速、稳定 |
| 圆通速递 | YTO | 性价比高 |
| 中通快递 | ZTO | 覆盖面广 |
| 韵达速递 | YD | 价格适中 |
| 申通快递 | STO | 网点多 |
| 百世快递 | HTKY | - |
| 京东物流 | JD | 自营物流 |
| EMS | EMS | 覆盖全国 |
添加物流公司：
- 点击"添加物流公司"
- 选择需要的物流公司
- 保存配置
步骤 3：获取发货管理密钥
操作路径： 发货信息管理服务 → API密钥管理
获取步骤：
- 点击"生成密钥"
- 管理员扫码确认
- 复制并保存密钥
⚠️ 重要： 密钥仅显示一次，请妥善保管！
步骤 4：配置回调地址
操作路径： 发货信息管理服务 → 回调配置
配置参数：
回调URL：https://api.example.com/wechat/shipping/callback
Token：自定义32位字符串说明： 当物流状态更新时，微信会回调此地址通知系统。
⚙️ 本系统系统配置
步骤 1：配置小程序基础信息
操作路径： 本系统后台 → 设置 → 系统设置 → 平台配置 → 小程序配置
配置参数：
| 参数名称 | 填写内容 | 获取位置 |
|---|---|---|
| 小程序AppID | wxXXXXXXXXXXXXXXXX | 小程序后台 → 开发设置 |
| 小程序AppSecret | XXXXXXXXXXXXXXXX | 小程序后台 → 开发设置 |
| 小程序名称 | XX商城 | 小程序后台 → 基本设置 |
提交保存
步骤 2：配置小程序支付
前提条件：
- 已开通微信支付商户号
- 已在商户平台关联小程序
配置路径： 设置 → 系统设置 → 平台配置 → 支付配置 → 小程序支付
配置参数：
| 参数 | 说明 | 示例 |
|---|---|---|
| 商户号 | 微信支付商户号 | 1234567890 |
| 商户密钥 | API密钥（32位） | abc123...（32位） |
| 证书文件 | apiclient_cert.pem | /cert/apiclient_cert.pem |
| 密钥文件 | apiclient_key.pem | /cert/apiclient_key.pem |
步骤 3：配置发货管理
操作路径： 设置 → 系统设置 → 平台配置 → 发货管理
配置参数：
| 参数 | 说明 | 获取位置 |
|---|---|---|
| 发货管理密钥 | 发货API密钥 | 小程序后台 → 发货信息管理服务 |
| 物流公司配置 | 启用的物流公司 | 同步小程序配置 |
| 自动同步开关 | 是否自动同步 | 建议开启 |
步骤 4：关闭充值功能（审核期）
⚠️ 重要提示：
小程序审核时，如果带有充值功能会被要求提供相关资料
（预付卡在线充值业务），建议在审核前关闭充值功能。
待审核通过后再开启。操作路径： 设置 → 系统设置 → 平台配置 → 支付/充值 → 充值配置
配置：
小程序充值开关：关闭何时开启：
- ✅ 小程序审核已通过
- ✅ 系统已稳定运行
- ✅ 已准备好相关资质（如需）
✅ 测试验证
测试 1：小程序扫码登录
步骤：
- 用微信扫描小程序码
- 进入小程序
- 尝试登录功能
- 检查是否能正常获取用户信息
成功标志：
- ✅ 能正常打开小程序
- ✅ 能获取用户头像和昵称
- ✅ 能正常浏览商品
测试 2：小程序支付
步骤：
- 在小程序中选择商品下单
- 提交订单
- 点击支付
- 完成微信支付
成功标志：
- ✅ 能正常调起微信支付
- ✅ 支付成功后订单状态更新
- ✅ 商户平台显示交易记录
测试 3：发货信息同步
步骤：
- 在后台发货订单
- 填写物流单号
- 提交发货
- 检查微信侧是否收到物流信息
成功标志：
- ✅ 发货信息成功同步到微信
- ✅ 用户能在"订单物流"中查看
- ✅ 物流状态能正常更新
验证方式：
用户端：我的订单 → 查看物流
应显示：物流公司、单号、实时状态❓ 常见问题
Q1：提示"不在以下request合法域名列表中"？
原因： 服务器域名未配置或配置错误
解决方案：
1. 登录小程序后台
2. 开发 → 开发设置 → 服务器域名
3. 添加或修改 request合法域名
4. 确保使用 HTTPS 协议
5. 保存后等待5-10分钟生效Q2：小程序支付失败？
可能原因：
- 商户号未关联小程序
- 商户密钥配置错误
- 证书文件路径错误
排查步骤：
1. 检查商户平台是否已关联小程序
2. 验证商户密钥是否正确（32位）
3. 确认证书文件已上传且路径正确
4. 查看系统日志中的具体错误信息Q3：发货信息同步失败？
可能原因：
- 未开通发货信息管理服务
- 发货密钥配置错误
- 物流公司代码不匹配
解决方案：
1. 确认已开通发货信息管理服务
2. 重新获取并配置发货密钥
3. 检查物流公司代码是否一致
4. 查看系统发货日志Q4：AppSecret 忘记了怎么办？
解决方案：
AppSecret 无法找回，只能重置：
1. 小程序后台 → 开发设置
2. 点击 AppSecret 旁的"重置"
3. 管理员扫码确认
4. 立即复制并保存新密钥
5. 更新 商城系统配置Q5：服务器域名每月只能修改5次，不够用？
建议：
1. 使用泛域名：*.example.com
2. 一次性配置所有可能用到的域名
3. 开发阶段可在开发工具中关闭域名验证
4. 生产环境必须严格配置Q6：小程序审核被拒，提示要求充值资质？
解决方案：
1. 关闭充值功能：
后台 → 充值配置 → 小程序充值开关 → 关闭
2. 重新提交审核
3. 审核通过后再开启充值功能
4. 如需长期开启充值，准备以下资质：
- 预付卡业务许可证
- 增值电信业务许可证🎯 最佳实践
1. 安全配置
密钥管理：
- ✅ AppSecret 不提交到代码仓库
- ✅ 使用环境变量存储敏感信息
- ✅ 定期更换密钥（3-6个月）
- ✅ 限制后台管理员权限
域名配置：
- ✅ 只配置必需的域名
- ✅ 使用 HTTPS 协议
- ✅ 定期检查SSL证书有效期
- ✅ 开启 HSTS 安全头
2. 发货管理建议
物流公司选择：
根据业务量选择：
- 小批量（<100单/天）：2-3家主流快递
- 中批量（100-500单/天）：3-5家快递
- 大批量（>500单/天）：5+家快递，包含EMS发货时效：
- 48小时内发货（用户体验好）
- 超过72小时可能被投诉
- 节假日提前告知
物流异常处理：
- 设置物流状态监控
- 超过7天未更新自动提醒
- 准备备用物流方案
3. 审核建议
提审前检查：
[ ] 充值功能已关闭
[ ] 商品信息完整（图片、描述）
[ ] 服务类目与实际经营一致
[ ] 隐私政策已配置
[ ] 用户协议已完善
[ ] 测试账号可用审核周期：
- 首次审核：3-7个工作日
- 更新审核：1-3个工作日
- 紧急审核：可申请加急
被拒后处理：
- 仔细阅读拒绝原因
- 逐条整改问题
- 补充说明材料
- 重新提交审核
4. 性能优化
小程序包大小：
- 主包：≤ 2MB
- 分包：每个 ≤ 2MB
- 总大小：≤ 20MB
优化建议：
1. 图片使用 CDN + WebP 格式
2. 按需加载分包
3. 使用组件懒加载
4. 减少 API 调用次数5. 运营建议
数据监控：
- 日活跃用户（DAU）
- 订单转化率
- 支付成功率
- 发货及时率
用户反馈：
- 及时处理投诉
- 收集用户建议
- 定期优化体验
📊 总结
配置流程回顾
注册小程序 → 企业认证 → 基础配置 →
开发配置 → 域名配置 → 发货管理配置 →
本系统系统配置 → 测试验证 → 提交审核关键要点
| 要点 | 说明 |
|---|---|
| ✅ 企业认证 | 必须完成，费用¥300/年 |
| ✅ HTTPS域名 | 必须配置SSL证书 |
| ✅ AppSecret | 妥善保管，仅显示一次 |
| ✅ 服务器域名 | 必须正确配置，每月限5次修改 |
| ✅ 发货管理 | 必须开通并配置 |
| ✅ 充值功能 | 审核期必须关闭 |
上线检查清单
配置阶段：
[ ] 小程序已认证
[ ] AppID 和 AppSecret 已获取
[ ] 服务器域名已配置
[ ] 发货管理已开通
[ ] 本系统系统已配置
测试阶段：
[ ] 登录功能正常
[ ] 支付功能正常
[ ] 发货同步正常
[ ] 充值功能已关闭
上线准备：
[ ] 隐私政策已完善
[ ] 服务类目已选择
[ ] 测试账号已准备🔗 相关文档
📚 参考资源
官方文档：
工具推荐：