将“若依”(RuoYi)微信小程序部署到阿里云服务器,涉及前后端分离架构的部署流程。若依通常提供基于 Spring Boot 的后端服务和 Vue 前端项目,而微信小程序作为前端客户端,通过 API 调用后端服务。
以下是详细的部署步骤:
一、准备工作
-
获取若依项目代码
- GitHub 地址:https://github.com/yangzongzhuan/RuoYi
- 推荐使用
RuoYi-Vue
或RuoYi-Weapp
(如果有微信小程序专用分支) - 若没有现成的小程序版本,可基于 RuoYi 后端 + 自定义小程序前端对接。
-
购买阿里云服务器(ECS)
- 系统:推荐 CentOS 7.x / Ubuntu 20.04
- 配置:至少 2核4G(根据访问量调整)
- 开放端口:
- 80(HTTP)
- 443(HTTPS)
- 8080(Spring Boot 默认端口)
- 22(SSH)
-
域名与备案
- 注册域名并完成 ICP 备案(国内服务器必须)
- 申请 SSL 证书(用于 HTTPS,微信小程序要求接口必须 HTTPS)
-
工具准备
- Xshell / FinalShell(连接服务器)
- Navicat / DBeaver(数据库管理)
- 微信开发者工具(调试小程序)
二、服务器环境搭建
1. 安装 Java 环境
# 查看是否已安装
java -version
# 安装 OpenJDK 8
sudo yum install java-1.8.0-openjdk-devel -y
2. 安装 MySQL
# 安装 MySQL 5.7 或 8.0
sudo yum install mysql-server -y
sudo systemctl start mysqld
sudo systemctl enable mysqld
# 登录并设置密码
mysql -u root -p
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的密码';
CREATE DATABASE ruoyi DEFAULT CHARSET utf8mb4;
3. 导入若依数据库
- 下载
RuoYi/sql/ry_*.sql
文件 - 使用 Navicat 或命令行导入:
mysql -u root -p ruoyi < ry_2023xxxx.sql
4. 安装 Redis(若需要)
yum install redis -y
systemctl start redis
systemctl enable redis
三、部署后端 Spring Boot 项目
方法一:直接运行 jar 包(推荐)
-
在本地 IDEA 中打包:
mvn clean package -Dmaven.test.skip=true
生成
ruoyi-admin/target/ruoyi-admin.jar
-
上传 jar 包到服务器(如
/home/ruoyi/
) -
修改配置文件
ruoyi-admin.jar
内部的application.yml
- 数据库连接地址改为服务器 IP 或内网地址
- Redis 地址
- 端口建议改为 8080
-
启动服务:
nohup java -jar ruoyi-admin.jar > ruoyi.log 2>&1 &
-
检查是否启动成功:
ps aux | grep java tail -f ruoyi.log
四、配置 Nginx(反向X_X + HTTPS)
-
安装 Nginx
yum install nginx -y systemctl start nginx systemctl enable nginx
-
上传 SSL 证书(从阿里云下载)
- 放在
/etc/nginx/cert/
- 放在
-
配置 Nginx(
/etc/nginx/conf.d/ruoyi.conf
)server { listen 443 ssl; server_name api.yourdomain.com; ssl_certificate /etc/nginx/cert/your_domain.pem; ssl_certificate_key /etc/nginx/cert/your_domain.key; location / { proxy_pass http://127.0.0.1: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; } }
HTTP 跳转 HTTPS
server {
listen 80;
server_name api.yourdomain.com;
return 301 https://$server_name$request_uri;
}
4. 重启 Nginx
```bash
nginx -t
systemctl restart nginx
五、微信小程序前端配置
- 打开微信开发者工具,导入小程序项目
- 修改请求域名:
- 在
project.config.json
和代码中,将 API 地址改为:https://api.yourdomain.com/
- 在
- 在微信公众平台配置:
- 登录 mp.weixin.qq.com
- 开发管理 → 开发设置 → 服务器域名
- 添加
request
合法域名:https://api.yourdomain.com
⚠️ 注意:微信小程序只允许 HTTPS 请求,且必须备案域名。
六、测试与上线
- 启动后端服务,确保接口可访问
- 小程序发起登录请求,测试能否正常获取数据
- 查看控制台是否有跨域或证书错误
- 正式发布小程序
常见问题
问题 | 解决方案 |
---|---|
接口 404 或无法访问 | 检查防火墙、安全组、Nginx 配置 |
微信提示域名未备案 | 必须完成 ICP 备案 |
SSL 证书无效 | 确保证书路径正确,浏览器可访问 |
数据库连接失败 | 检查 MySQL 是否允许远程连接(若跨服务器) |
可选优化
- 使用 PM2 或 systemd 管理 Java 进程
- 配置定时备份数据库
- 使用阿里云 RDS 替代本地 MySQL
- 添加日志监控(如 ELK)
总结
部署流程:
本地打包 → 上传服务器 → 配置数据库 → 启动后端 → Nginx 反向X_X → 小程序配置域名 → 测试上线
只要确保:
- 后端服务正常运行
- 域名备案 + HTTPS
- 小程序配置正确
即可顺利完成部署。
如需,我可以提供 application.yml
示例、Nginx 配置模板或 shell 启动脚本。