如何将微信小程序部署到腾讯云CVM服务器?

微信小程序不能直接部署到 CVM 服务器。这是一个常见的误解,需要澄清:

🔑 核心原理

  • 小程序是前端应用:运行在微信客户端(手机 App)内,代码由微信引擎解析执行。
  • CVM 是后端服务器:用于部署小程序的后端服务(如 API 接口、数据库、业务逻辑等)。
  • 正确架构
    用户手机 → 微信小程序(前端)→ 腾讯云 CVM(后端 API)

✅ 正确部署流程(分两步)

第一步:准备小程序前端代码

  1. 在微信开发者工具中完成小程序开发
  2. 点击「上传」将前端代码提交到微信公众平台
  3. 在微信公众平台审核发布(无需涉及 CVM

第二步:部署后端服务到 CVM

  1. 创建 CVM 实例

    • 登录 腾讯云控制台
    • 购买 Linux 系统 CVM(推荐 CentOS/Ubuntu)
    • 配置安全组:开放 80/443/自定义端口(如 3000)
  2. 安装运行环境

    # Ubuntu 示例
    sudo apt update
    sudo apt install nodejs npm git -y
    # 或安装 Nginx + PM2
    sudo apt install nginx pm2 -y
  3. 部署后端代码

    # 克隆项目
    git clone https://github.com/your-repo/backend.git
    cd backend
    
    # 安装依赖
    npm install
    
    # 配置环境变量(.env 文件)
    echo "NODE_ENV=production" >> .env
    echo "PORT=3000" >> .env
    
    # 使用 PM2 启动服务
    npm install -g pm2
    pm2 start app.js --name my-api
    pm2 startup
    pm2 save
  4. 配置域名与 HTTPS

    • 购买域名并备案(国内必须)
    • 在 CVM 安装 Nginx 反向X_X
    • 申请 SSL 证书(腾讯云免费证书)
    • 修改小程序 app.json 中的 request 配置:
      {
      "request": {
       "secure": true,
       "timeout": 5000
      }
      }
  5. 更新小程序请求地址

    • 在微信公众平台 → 开发管理 → 开发设置 → 服务器域名
    • 添加你的 CVM 公网 IP 或域名(需 HTTPS)

⚠️ 关键注意事项

项目 说明
HTTPS 强制要求 所有网络请求必须使用 HTTPS(微信强制)
域名备案 中国大陆 CVM 域名需 ICP 备案
IP 限制 小程序只能访问已配置的服务器域名/IP
安全组规则 务必开放对应端口(如 3000/Nginx 80/443)

📌 常见错误排查

  1. 请求失败:检查微信公众平台是否添加了服务器域名
  2. 403/404 错误:验证 Nginx 配置和后端服务状态
  3. SSL 证书无效:确保证书未过期且域名匹配
  4. 无法连接:检查 CVM 安全组规则和防火墙(ufw disable

💡 提示:首次部署建议使用腾讯云服务器监控+云监控告警功能,实时查看服务状态。如需快速验证,可先用内网测试环境调试后再上线。

按照以上步骤操作,即可实现小程序前端与 CVM 后端服务的完整部署。