微信小程序接入腾讯云服务器进行后端部署,是一个常见的开发场景。以下是详细的步骤和流程,帮助你完成从开发到部署的全过程。
一、整体架构
微信小程序客户端 ←→ 腾讯云服务器(Node.js/PHP/Python等) ←→ 数据库(如 MySQL / MongoDB)
你需要:
- 开发后端 API 接口(运行在腾讯云服务器上)
- 小程序通过
wx.request()调用这些接口 - 服务器处理请求并返回数据
二、准备工作
1. 注册账号
- 微信开放平台:获取小程序 AppID
- 腾讯云官网:注册账号并实名认证
2. 创建云服务器(CVM)
- 登录腾讯云控制台 → 进入【云服务器 CVM】
- 点击“新建实例”
- 选择配置:
- 地域:建议选靠近用户的位置(如广州、上海)
- 镜像:推荐使用 Ubuntu Server 或 CentOS
- 实例规格:入门可选 1核2G
- 安全组:确保开放 80(HTTP)、443(HTTPS)、22(SSH) 端口
⚠️ 记得下载并保存 SSH 密钥(
.pem文件),用于登录服务器。
三、部署后端服务
1. 登录服务器(使用 SSH)
ssh root@你的服务器公网IP
# 或使用密钥
ssh -i ~/path/to/your-key.pem root@公网IP
2. 安装必要环境(以 Node.js + Express 为例)
# 更新系统
sudo apt update
# 安装 Node.js 和 npm
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 安装 PM2(进程管理)
npm install -g pm2
# 安装 Nginx(反向X_X)
sudo apt install nginx
3. 上传并运行后端代码
将你的后端项目(例如 Express)上传到服务器:
# 使用 scp 上传文件
scp -i your-key.pem -r ./backend root@公网IP:/root/myapp
进入服务器运行:
cd /root/myapp
npm install
pm2 start app.js --name "my-wechat-api"
默认监听 3000 端口。
四、配置域名与 HTTPS(重要!)
微信小程序要求所有网络请求必须是 HTTPS 协议,且域名需备案并加入「request 合法域名」。
1. 购买并备案域名
- 在腾讯云购买域名(如
api.yourdomain.com) - 提交备案(国内服务器必须备案)
2. 申请免费 SSL 证书
- 腾讯云搜索 “SSL证书” → 申请免费 TrustAsia 证书
- 下载 Nginx 版本证书
3. 配置 Nginx 反向X_X + HTTPS
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
内容示例:
server {
listen 80;
server_name api.yourdomain.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl;
server_name api.yourdomain.com;
ssl_certificate /root/ssl/api_yourdomain_com.crt;
ssl_certificate_key /root/ssl/api_yourdomain_com.key;
location / {
proxy_pass http://127.0.0.1:3000; # 转发到本地 Node 服务
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
上传证书并重启 Nginx:
sudo nginx -t # 测试配置
sudo systemctl reload nginx
五、小程序端调用 API
在小程序中发起请求:
wx.request({
url: 'https://api.yourdomain.com/user/info',
method: 'GET',
success(res) {
console.log(res.data)
},
fail(err) {
console.error('请求失败', err)
}
})
✅ 注意:该域名必须在小程序管理后台配置为「request 合法域名」
六、在小程序管理后台配置域名
- 登录 微信公众平台
- 进入「开发」→「开发管理」→「开发设置」
- 在「服务器域名」中添加:
- request 合法域名:
https://api.yourdomain.com
- request 合法域名:
⚠️ 不支持 IP 地址或 HTTP 请求!
七、可选优化
| 功能 | 建议 |
|---|---|
| 数据库存储 | 使用腾讯云 云数据库 MySQL |
| 文件存储 | 使用 COS(对象存储) 存图片、视频 |
| 自动部署 | 使用 CI/CD 工具(如 Jenkins、GitHub Actions) |
| 日志监控 | 使用 PM2 日志或腾讯云 CLS |
八、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 请求失败 net::ERR_SSL_PROTOCOL_ERROR | 检查 SSL 证书是否正确安装 |
| 域名未备案 | 小程序无法调用未备案域名 |
| 接口返回 404 | 检查 Nginx 是否正确X_X到后端端口 |
| 无法连接服务器 | 检查安全组是否开放 80/443/22 端口 |
| 小程序提示“不在以下 request 合法域名列表中” | 登录后台添加域名 |
总结
✅ 步骤总结:
- 腾讯云购买 CVM 并部署后端服务(Node.js/Python等)
- 配置 Nginx + HTTPS + 域名
- 小程序通过
wx.request调用 HTTPS 接口 - 在小程序后台配置合法域名
如果你使用的是 腾讯云 TCB(云开发),也可以直接使用云函数和云数据库,无需自己搭服务器,更加简单。但若需要自定义后端逻辑,上述 CVM 方案更灵活。
如有具体技术栈(如 Python Flask、Java Spring Boot),可提供进一步部署指导。
云小栈