微信小程序不能直接部署到 CVM 服务器。这是一个常见的误解,需要澄清:
🔑 核心原理
- 小程序是前端应用:运行在微信客户端(手机 App)内,代码由微信引擎解析执行。
- CVM 是后端服务器:用于部署小程序的后端服务(如 API 接口、数据库、业务逻辑等)。
- 正确架构:
用户手机 → 微信小程序(前端)→ 腾讯云 CVM(后端 API)
✅ 正确部署流程(分两步)
第一步:准备小程序前端代码
- 在微信开发者工具中完成小程序开发
- 点击「上传」将前端代码提交到微信公众平台
- 在微信公众平台审核发布(无需涉及 CVM)
第二步:部署后端服务到 CVM
-
创建 CVM 实例
- 登录 腾讯云控制台
- 购买 Linux 系统 CVM(推荐 CentOS/Ubuntu)
- 配置安全组:开放 80/443/自定义端口(如 3000)
-
安装运行环境
# Ubuntu 示例 sudo apt update sudo apt install nodejs npm git -y # 或安装 Nginx + PM2 sudo apt install nginx pm2 -y -
部署后端代码
# 克隆项目 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 -
配置域名与 HTTPS
- 购买域名并备案(国内必须)
- 在 CVM 安装 Nginx 反向X_X
- 申请 SSL 证书(腾讯云免费证书)
- 修改小程序
app.json中的request配置:{ "request": { "secure": true, "timeout": 5000 } }
-
更新小程序请求地址
- 在微信公众平台 → 开发管理 → 开发设置 → 服务器域名
- 添加你的 CVM 公网 IP 或域名(需 HTTPS)
⚠️ 关键注意事项
| 项目 | 说明 |
|---|---|
| HTTPS 强制要求 | 所有网络请求必须使用 HTTPS(微信强制) |
| 域名备案 | 中国大陆 CVM 域名需 ICP 备案 |
| IP 限制 | 小程序只能访问已配置的服务器域名/IP |
| 安全组规则 | 务必开放对应端口(如 3000/Nginx 80/443) |
📌 常见错误排查
- 请求失败:检查微信公众平台是否添加了服务器域名
- 403/404 错误:验证 Nginx 配置和后端服务状态
- SSL 证书无效:确保证书未过期且域名匹配
- 无法连接:检查 CVM 安全组规则和防火墙(
ufw disable)
💡 提示:首次部署建议使用腾讯云服务器监控+云监控告警功能,实时查看服务状态。如需快速验证,可先用内网测试环境调试后再上线。
按照以上步骤操作,即可实现小程序前端与 CVM 后端服务的完整部署。
PHPWP博客