一、准备工作（必须先搞定）
1. 服务器：阿里云/腾讯云等，系统选CentOS 7+，已安装宝塔面板（一键安装命令）
2. 域名：已备案域名（小程序强制HTTPS），解析到服务器IP
3. 小程序账号：微信公众平台注册，获取AppID、AppSecret
4. 后端源码：PHP（推荐）/Java/Node.js 等，本地调试正常
二、宝塔部署后端（以PHP为例，最常用）
1. 安装环境
登录宝塔 → 软件商店 → 安装：
- Nginx（最新版）
- PHP 7.4/8.0（根据项目需求）
- MySQL 5.7/8.0
- 可选：Redis、PM2（Node.js用）
2. 添加站点（关键）
1. 网站 → 添加站点 → 填已备案域名（如 api.xxx.com）
2. 根目录：默认 /www/wwwroot/api.xxx.com
3. PHP版本：选刚才安装的 → 提交
3. 上传后端源码
1. 进入站点根目录 → 删除默认文件
2. 上传本地源码（压缩包上传后解压，或直接拖文件）
4. 创建数据库
1. 数据库 → 添加数据库 → 填库名、用户名、密码（记好）
2. 导入本地数据库SQL文件（phpMyAdmin导入）
5. 修改项目配置
找到数据库配置文件（如 .env 或 config.php ），填入宝塔数据库信息：
6. 配置HTTPS（小程序强制）
1. 网站 → 站点设置 → SSL → 申请免费Let’s Encrypt证书
2. 开启强制HTTPS → 保存
7. 伪静态（可选，框架项目需配）
网站 → 伪静态 → 选对应框架（如ThinkPHP/Laravel）→ 保存
8. 测试后端
浏览器访问 https://你的域名/api/test ，能正常返回数据即部署成功。
三、小程序前端对接（关键）
1. 微信开发者工具 → 项目详情 → 本地设置 → 勾选不校验合法域名（开发环境用）
2. 小程序请求API时，把域名换成HTTPS的宝塔域名：
3. 正式发布前：微信公众平台 → 开发 → 开发设置 → 服务器域名 → 配置request合法域名（填你的HTTPS域名）
四、其他语言后端部署（简要）
- Java（SpringBoot）：宝塔安装Java环境 → 上传JAR包 → 软件商店安装Java项目管理器 → 配置端口→启动→反向代理到域名
- Node.js（Express/Koa）：软件商店安装PM2 → 上传源码 → 终端 npm install → PM2启动 → 反向代理
五、常见坑与解决
1. 小程序请求报错：合法域名校验失败
- 解决：必须备案域名+HTTPS，正式环境关闭“不校验”，配置公众平台合法域名
2. 后端404
- 解决：伪静态规则错误、运行目录没设为 public （Laravel/ThinkPHP）
3. 数据库连接失败
- 解决：配置文件信息错误、数据库没授权远程访问（宝塔数据库→权限设置）
标签：一般
相关文章
发表评论: