Skip to main content

小程序配置指南

本指南将帮助您完成微信小程序后台的配置，包括域名要求、业务域名配置和校验流程。

前置准备​

域名要求​

在开始配置前，请确保您的域名满足以下条件：

  • ✅ 域名必须经过 ICP 备案
  • ✅ 新备案域名需等待 24 小时后才可配置
  • ✅ 域名格式：仅支持英文大小写字母、数字及 -
  • ❌ 不支持 IP 地址
  • ❌ 不支持端口号（如 domain.com:8080）
  • ✅ 必须使用 HTTPS 协议

示例：

  • ✅ 正确：h5.example.com、app.example.com
  • ❌ 错误：192.168.1.1、example.com:8080、http://example.com

服务器环境​

假设您已具备：

  • Web 服务器（Nginx、Node.js 或其他）
  • 已配置好的 HTTPS/SSL 证书
  • 公网域名
提示

如果您还没有配置服务器，请先参考 服务器部署配置。

微信小程序后台配置流程​

登录微信公众平台​

  1. 访问微信公众平台：https://mp.weixin.qq.com/
  2. 使用管理员微信扫码登录
  3. 导航至：开发 → 开发设置 → 业务域名

📖 参考微信官方配置文档

下载校验文件​

操作步骤​

  1. 在"业务域名"配置区域点击 "添加" 或 "编辑"
  2. 输入您的 H5 域名（如 h5.example.com）
  3. 点击后会提示下载校验文件
  4. 下载文件到本地

校验文件说明​

  • 文件命名规则：纯随机字符串 + .txt 后缀
    • 例如：a1b2c3d4e5f6.txt、9f8e7d6c5b4a.txt
    • 文件名没有固定前缀，就是一串随机字符
    • 每个域名对应唯一的校验文件
  • 文件内容：一串随机字符（不要修改）
  • 文件作用：证明您拥有该域名的控制权

微信小程序业务域名配置示例

校验机制原理​

微信配置业务域名时的验证流程：

┌─────────────┐         ┌──────────────┐         ┌─────────────┐
│  微信服务器  │  HTTPS  │   您的服务器   │  返回    │  校验文件     │
│             │ ───────>│              │ ───────>│  内容        │
│ 发起请求     │  GET    │ Nginx/Nodejs │  文件    │  (随机字符)   │
└─────────────┘         └──────────────┘         └─────────────┘

请求 URL：https://h5.example.com/a1b2c3d4e5f6.txt（随机字符串）

验证规则：

  1. 微信通过 HTTPS GET 请求访问：https://yourdomain.com/随机字符串.txt（如 a1b2c3d4e5f6.txt）
  2. 服务器必须返回 200 状态码和正确的文件内容
  3. 验证成功后，域名才能保存到业务域名列表
重要

校验文件必须可以通过 HTTPS 公网访问。在微信后台验证之前，需要先将文件部署到服务器上。请参考 Nginx 配置 或 Node.js 配置 完成文件部署。

部署验证​

验证校验文件可访问​

方法一：浏览器访问​

在浏览器地址栏输入（将 a1b2c3d4e5f6.txt 替换为您实际下载的文件名）：

https://h5.example.com/a1b2c3d4e5f6.txt

预期结果：

  • 页面显示一串随机字符（校验文件内容）
  • 状态码为 200
  • 无 404 或 403 错误

方法二：使用 curl 命令验证​

# 基本验证（替换为您实际的文件名）
curl https://h5.example.com/a1b2c3d4e5f6.txt

# 查看详细的 HTTP 响应头
curl -I https://h5.example.com/a1b2c3d4e5f6.txt

# 预期输出：
# HTTP/2 200
# content-type: text/plain
# ...

微信后台验证​

完成服务器配置后，返回微信公众平台：

  1. 在"业务域名"配置页面
  2. 确认域名已填写：h5.example.com
  3. 点击 "保存" 按钮
  4. 等待微信服务器验证（通常几秒钟）

验证成功提示：

✅ 验证成功
域名已添加到业务域名列表

验证失败提示：

❌ 无法访问校验文件
请检查文件是否上传到域名根目录
常见问题

如果验证失败，请参考 问题排查 - 校验文件访问失败。

小程序中测试 WebView​

在小程序页面中使用 WebView​

WXML 代码：

<!-- pages/webview/webview.wxml -->
<web-view src="https://h5.example.com"></web-view>

JSON 配置：

{
  "navigationBarTitleText": "H5 页面",
  "enablePullDownRefresh": false
}

开发者工具测试​

  1. 打开微信开发者工具
  2. 在模拟器中预览 WebView 页面
  3. 检查是否正常加载 H5 页面
注意

开发者工具可能对域名校验不严格，建议进行真机测试。

真机测试（重要）​

  1. 点击开发者工具的 "预览" 按钮
  2. 使用手机微信扫码
  3. 在真机上测试 WebView 是否正常显示

常见问题：

  • 如果显示白屏，检查域名是否配置成功
  • 如果提示"网页无法打开"，检查 HTTPS 证书是否有效
下一步

完成小程序配置后，您可以：

相关资源​