加油
努力

微信小程序如何接入腾讯云服务器进行后端部署?

微信小程序接入腾讯云服务器进行后端部署,是一个常见的开发场景。以下是详细的步骤和流程,帮助你完成从开发到部署的全过程。


一、整体架构

微信小程序客户端 ←→ 腾讯云服务器(Node.js/PHP/Python等) ←→ 数据库(如 MySQL / MongoDB)

你需要:

  1. 开发后端 API 接口(运行在腾讯云服务器上)
  2. 小程序通过 wx.request() 调用这些接口
  3. 服务器处理请求并返回数据

二、准备工作

1. 注册账号

  • 微信开放平台:获取小程序 AppID
  • 腾讯云官网:注册账号并实名认证

2. 创建云服务器(CVM)

  1. 登录腾讯云控制台 → 进入【云服务器 CVM】
  2. 点击“新建实例”
  3. 选择配置:
    • 地域:建议选靠近用户的位置(如广州、上海)
    • 镜像:推荐使用 Ubuntu ServerCentOS
    • 实例规格:入门可选 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 合法域名」


六、在小程序管理后台配置域名

  1. 登录 微信公众平台
  2. 进入「开发」→「开发管理」→「开发设置」
  3. 在「服务器域名」中添加:
    • request 合法域名:https://api.yourdomain.com

⚠️ 不支持 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 合法域名列表中” 登录后台添加域名

总结

✅ 步骤总结:

  1. 腾讯云购买 CVM 并部署后端服务(Node.js/Python等)
  2. 配置 Nginx + HTTPS + 域名
  3. 小程序通过 wx.request 调用 HTTPS 接口
  4. 在小程序后台配置合法域名

如果你使用的是 腾讯云 TCB(云开发),也可以直接使用云函数和云数据库,无需自己搭服务器,更加简单。但若需要自定义后端逻辑,上述 CVM 方案更灵活。

如有具体技术栈(如 Python Flask、Java Spring Boot),可提供进一步部署指导。

云服务器