将微信小程序发布到服务器上,主要包括以下几个步骤。这里假设你已经完成了小程序的本地开发,并且需要部署后端服务(如 Node.js、Java、PHP、Python 等)来支持小程序的功能(比如接口请求、数据存储等)。
一、准备阶段
1. 准备服务器
你可以选择以下类型的服务器:
- 云服务器:阿里云、腾讯云、华为云、AWS、DigitalOcean 等。
- 云开发平台:微信小程序自带的「云开发」功能(适合轻量级项目)。
- 虚拟主机/共享主机(不推荐,限制多)
推荐使用 云服务器 + 自建后端服务 或者 微信云开发。
二、部署后端服务(以 Node.js 为例)
1. 将你的后端代码上传到服务器
可以使用以下方式:
- 使用
scp或rsync命令上传文件 - 使用 Git 拉取代码(推荐)
git clone https://your-repo.git
2. 安装依赖并启动服务
进入项目目录:
cd your-project
npm install
npm start
确保服务监听的是 0.0.0.0 而不是 127.0.0.1,这样外部才能访问。
例如 Express 启动:
app.listen(3000, '0.0.0.0', () => {
console.log('Server is running on port 3000');
});
3. 配置防火墙
开放你需要用的端口(如 80、443、3000):
- 登录云服务器控制台,配置安全组规则
- 或者在服务器上运行命令:
ufw allow 3000
三、配置域名白名单(重要!)
微信小程序要求:
所有网络请求必须使用 HTTPS 协议,并且域名必须在微信公众平台中添加为白名单。
步骤如下:
- 登录 微信公众平台
- 左侧菜单 → 开发管理 → 开发设置 → 服务器域名
- 添加你的服务器地址到以下列表:
- request合法域名
- uploadFile合法域名
- downloadFile合法域名
- socket合法域名
⚠️ 注意:
- 必须是 HTTPS
- 不支持 IP 地址(除非备案了)
- 不能带端口号(如
https://example.com:3000是不允许的)
四、上传小程序代码到微信公众平台
1. 在开发者工具中上传代码
打开微信开发者工具:
- 点击右上角的 "上传" 按钮
- 输入版本号和项目描述
- 提交审核前可以选择测试人员体验
2. 提交审核
登录微信公众平台:
- 左侧菜单 → 版本管理 → 开发版本 → 提交审核
五、可选:使用微信云开发快速部署
如果你不想自己搭建服务器,可以使用微信官方提供的「云开发」功能,它提供:
- 云数据库
- 云函数(代替后端接口)
- 云存储
- HTTP 请求能力(需开通)
启用方式:
- 微信开发者工具中创建云开发项目
- 编写云函数处理业务逻辑
- 无需配置域名,直接调用微信 SDK 访问资源
六、常见问题排查
| 问题 | 解决方法 |
|---|---|
| 请求被拦截 | 检查域名是否添加到白名单、是否 HTTPS |
| 无法访问服务器 | 检查防火墙、安全组、服务器是否运行 |
| 接口返回 502 | 检查后端服务是否正常运行 |
| 上传失败 | 检查 AppID 是否正确,是否有权限 |
总结流程图
小程序代码开发 → 后端部署服务器 → 配置域名白名单 → 上传小程序代码 → 提交审核
如果你能告诉我你使用的后端语言(如 Node.js、Python、Java)、是否想用云开发,我可以给出更具体的部署指南。欢迎继续提问!
ECLOUD博客