微信小程序部署到服务器的完整流程
结论与核心观点
微信小程序开发完成后,部署到服务器的核心步骤包括:配置合法域名、上传代码至微信开发者工具、配置服务器环境(如Nginx或Apache)、上传后端代码(如有)、测试并提交审核。以下是详细步骤:
1. 配置合法域名(必须步骤)
- 微信小程序要求所有网络请求必须使用HTTPS,因此服务器必须支持SSL证书(如Let’s Encrypt免费证书)。
- 在小程序后台(mp.weixin.qq.com)的 「开发」→「开发管理」→「开发设置」 中,添加服务器域名:
request合法域名
(API接口)socket合法域名
(WebSocket)uploadFile合法域名
(文件上传)downloadFile合法域名
(文件下载)
- 注意:域名需备案(国内服务器),且证书有效。
2. 上传小程序代码
- 使用微信开发者工具完成:
- 点击 「上传」 按钮,填写版本号和备注。
- 上传后,代码会存储在微信平台,但仍需部署服务器端(如后端API或静态资源)。
3. 服务器端部署(关键步骤)
(1)静态资源部署(如H5页面)
- 若小程序内嵌WebView,需将HTML/CSS/JS文件上传至服务器:
- 使用FTP/SFTP或Git部署到服务器目录(如
/var/www/miniprogram
)。 - 配置Nginx/Apache指向该目录,并启用HTTPS。
- 使用FTP/SFTP或Git部署到服务器目录(如
(2)后端API部署
- Node.js/Python/Java等后端项目:
- 通过PM2(Node)、uWSGI(Python)或Docker容器化部署。
- 示例(Node.js + PM2):
pm2 start app.js --name miniprogram-api
- 数据库配置:
- 确保数据库(MySQL/MongoDB等)可远程访问(需设置白名单IP)。
4. 测试与调试
- 本地测试:使用微信开发者工具的「真机调试」功能。
- 服务器测试:
- 检查API接口是否返回正确数据(如
https://api.yourdomain.com/login
)。 - 使用Postman或浏览器验证HTTPS证书有效性。
- 检查API接口是否返回正确数据(如
5. 提交审核与发布
- 在微信开发者工具上传代码后,登录小程序后台提交审核。
- 审核通过后,点击 「发布」 即可上线。
常见问题与注意事项
- 域名未备案:国内服务器必须备案,海外服务器可免但可能影响访问速度。
- HTTPS证书错误:检查证书链是否完整(可用SSL Labs检测)。
- 跨域问题:后端需配置CORS(如Node.js的
cors
中间件)。
总结
微信小程序部署的核心是 「合法域名+HTTPS+服务器配置」。按步骤操作后,即可完成全流程。重点:确保域名合法、证书有效、接口可访问。