小程序部署全流程实战指南

很多独立开发者把小程序写完、本地跑通之后，一到「部署上线」这一步就卡住了。其实小程序部署分成两条线：一条是前端代码的提交与发布，另一条是后端服务器的部署。两条线都走通，用户才能真正用上你的小程序。这篇文章把两条线都讲清楚。

一、先理清：小程序部署到底包含什么

• 前端：小程序代码包上传到微信平台，提交审核并发布
• 后端：服务器、域名、HTTPS、数据库等基础设施的部署
• 配置：服务器域名白名单、业务域名、合法域名校验

很多教程只讲前端上传，结果新手卡在「request 合法域名校验失败」，其实问题出在后端和域名配置上。

二、微信小程序前端部署

1. 准备工作

• 注册小程序账号，拿到 AppID
• 在「开发管理 - 开发设置」里配置服务器域名
• 下载并安装微信开发者工具

2. 上传代码

在开发者工具右上角点击「上传」，填写版本号和项目备注。上传成功后，进入微信公众平台「版本管理」，可以看到「开发版本」。

3. 提交审核与发布

在版本管理里把开发版本「提交审核」，填写功能页面、测试账号等信息。审核一般 1-3 个工作日，通过后点击「发布」，小程序就正式上线了。发布后还可以配置「体验版」，方便内部测试。

提示：首次提审前务必确认类目、隐私协议、用户信息授权都已配置，否则很容易被驳回。

三、微信小程序服务器部署

如果你的小程序需要登录、支付、数据存储，就离不开后端服务器。下面以最常见的「Node.js + 云服务器」为例。

1. 购买服务器与域名

• 云服务器：阿里云、腾讯云等，入门配置 2核2G 足够个人项目
• 域名：需完成 ICP 备案，否则无法在小程序里使用
• SSL 证书：小程序要求 HTTPS，可申请免费证书

2. 部署后端服务

把后端代码上传到服务器，用 pm2 守护进程：

# 安装依赖并启动
npm install
pm2 start app.js --name miniapp-api
pm2 save
pm2 startup

然后用 Nginx 反向代理并配置 HTTPS：

server {
  listen 443 ssl;
  server_name api.example.com;
  ssl_certificate /etc/nginx/cert/example.pem;
  ssl_certificate_key /etc/nginx/cert/example.key;
  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
  }
}

3. 配置合法域名

回到微信公众平台，把 https://api.example.com 加入 request 合法域名。注意：必须是 HTTPS，且不能带端口号。

四、更省事的方案：微信云开发

如果你不想折腾服务器、备案、证书，可以直接用微信云开发。它提供云函数、云数据库、云存储，天然免鉴权，无需配置域名。适合个人开发者和小型项目。

• 优点：零运维、免备案、按量计费
• 缺点：绑定微信生态，迁移成本高

五、部署常见坑与排查

1. request 合法域名校验失败：检查域名是否 HTTPS、是否已配置
2. 证书过期：设置自动续期或提醒
3. 服务器 502：检查后端进程是否存活、Nginx 配置是否正确
4. 审核被拒：仔细阅读驳回原因，常见是类目不符或缺少隐私协议

总结一下：小程序部署 = 前端上传发布 + 后端服务器部署 + 域名配置。个人项目建议优先考虑云开发，等业务增长再迁移到自建服务器。把这两条线都跑通一次，以后再部署就轻车熟路了。