将“若依”(RuoYi)微信小程序部署到阿里云服务器,需要分为两个部分来理解:
- 后端服务:通常是 RuoYi 提供的 Spring Boot 后端项目(如
ruoyi-vue或ruoyi-cloud的后端模块),负责提供 API 接口。 - 前端/小程序:微信小程序本身运行在微信客户端,但其前端代码不需要部署到服务器;真正需要部署的是后端 API 服务。
因此,部署的核心是将 RuoYi 后端部署到阿里云服务器上,供微信小程序调用接口。
✅ 一、准备工作
1. 购买阿里云服务器(ECS)
- 登录 阿里云官网
- 购买一台 ECS 实例(推荐配置:2核4G,Ubuntu/CentOS 7+)
- 开放以下端口:
80(HTTP)443(HTTPS)8080(Spring Boot 默认端口)22(SSH 远程连接)
2. 域名(可选但推荐)
- 如果要使用 HTTPS,建议购买并备案一个域名。
- 在阿里云控制台完成域名解析(指向你的 ECS 公网 IP)。
3. 微信小程序配置
- 在微信公众平台设置合法域名(request 合法域名):
- 示例:
https://api.yourdomain.com
- 示例:
- 必须使用 HTTPS 协议。
✅ 二、部署 RuoYi 后端到阿里云
步骤 1:远程连接 ECS
ssh root@你的公网IP
步骤 2:安装必要环境
# 更新系统
sudo apt update # Ubuntu/Debian
# 或 yum update # CentOS
# 安装 Java 8 或 11(RuoYi 通常基于 Spring Boot)
sudo apt install openjdk-11-jdk -y
# 安装 MySQL
sudo apt install mysql-server -y
# 设置密码,创建数据库 ruoyi
# 安装 Redis(若使用缓存)
sudo apt install redis-server -y
步骤 3:导入数据库
- 从本地 RuoYi 项目中导出
sql文件(通常在ruoyi/sql/目录下) - 使用 Navicat / DBeaver / 命令行导入到阿里云 MySQL
CREATE DATABASE ruoyi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE ruoyi;
SOURCE /path/to/ry_2023xxxx.sql;
步骤 4:修改 RuoYi 配置文件
修改 application.yml 中的数据库连接信息:
spring:
datasource:
url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
username: root
password: 你的MySQL密码
步骤 5:打包项目
在本地使用 Maven 打包:
mvn clean package -DskipTests
生成的 JAR 文件通常在 target/ruoyi.jar
步骤 6:上传 JAR 到服务器
使用 scp 或 FTP 工具上传:
scp ruoyi.jar root@你的IP:/root/
步骤 7:启动 Spring Boot 项目
nohup java -jar ruoyi.jar > app.log 2>&1 &
项目默认运行在
http://服务器IP:8080
✅ 三、配置 Nginx 反向X_X(推荐)
1. 安装 Nginx
sudo apt install nginx -y
2. 配置反向X_X
编辑配置文件:
sudo nano /etc/nginx/sites-available/default
添加如下内容:
server {
listen 80;
server_name api.yourdomain.com; # 改为你的域名
location / {
proxy_pass http://localhost:8080;
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 systemctl restart nginx
3. (可选)配置 HTTPS(使用 Let’s Encrypt)
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d api.yourdomain.com
✅ 四、微信小程序端配置
在微信开发者工具中,修改请求域名:
// 示例 request 请求
wx.request({
url: 'https://api.yourdomain.com/api/login',
// ...
})
确保:
- 域名已配置为 HTTPS
- 已在「小程序管理后台」>「开发」>「开发设置」中添加到 request 合法域名列表
✅ 五、常见问题排查
| 问题 | 解决方案 |
|---|---|
| 小程序请求失败 | 检查域名是否备案、是否启用 HTTPS |
| 连接数据库失败 | 检查 MySQL 是否允许本地连接,防火墙设置 |
| 接口返回 404 | 检查 Nginx 是否正确X_X,Spring Boot 是否启动成功 |
| 启动报错内存不足 | 给 JVM 设置内存参数:java -Xms512m -Xmx1024m -jar ruoyi.jar |
✅ 六、进阶建议
- 使用 Jenkins / GitHub Actions 实现自动化部署
- 使用 Supervisor 管理 Java 进程,防止崩溃
- 使用 阿里云 RDS 替代本地 MySQL,更稳定
- 使用 Docker 部署(更推荐):
docker run -d -p 8080:8080 --name ruoyi ruoyi-image
总结
🌟 核心要点:
- 微信小程序本身不部署,只部署其调用的后端 API
- 若依后端部署到阿里云 ECS,通过 Nginx + HTTPS 对外提供服务
- 小程序配置合法域名,发起 HTTPS 请求
如果你使用的是 RuoYi-Uniapp 或 RuoYi-Vue3 的小程序版本,流程类似,只需确保前后端分离架构下的 API 地址正确指向阿里云服务器即可。
如需具体某一步的详细操作(比如 Docker 部署或自动 CI/CD),欢迎继续提问!
CLOUD技术博