若依微信小程序部署到阿里云服务器?

云计算

将“若依”(RuoYi)微信小程序部署到阿里云服务器,涉及前后端分离架构的部署流程。若依通常提供基于 Spring Boot 的后端服务和 Vue 前端项目,而微信小程序作为前端客户端,通过 API 调用后端服务。

以下是详细的部署步骤:


一、准备工作

  1. 获取若依项目代码

    • GitHub 地址:https://github.com/yangzongzhuan/RuoYi
    • 推荐使用 RuoYi-VueRuoYi-Weapp(如果有微信小程序专用分支)
    • 若没有现成的小程序版本,可基于 RuoYi 后端 + 自定义小程序前端对接。
  2. 购买阿里云服务器(ECS)

    • 系统:推荐 CentOS 7.x / Ubuntu 20.04
    • 配置:至少 2核4G(根据访问量调整)
    • 开放端口:
      • 80(HTTP)
      • 443(HTTPS)
      • 8080(Spring Boot 默认端口)
      • 22(SSH)
  3. 域名与备案

    • 注册域名并完成 ICP 备案(国内服务器必须)
    • 申请 SSL 证书(用于 HTTPS,微信小程序要求接口必须 HTTPS)
  4. 工具准备

    • 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 包(推荐)

  1. 在本地 IDEA 中打包:

    mvn clean package -Dmaven.test.skip=true

    生成 ruoyi-admin/target/ruoyi-admin.jar

  2. 上传 jar 包到服务器(如 /home/ruoyi/

  3. 修改配置文件 ruoyi-admin.jar 内部的 application.yml

    • 数据库连接地址改为服务器 IP 或内网地址
    • Redis 地址
    • 端口建议改为 8080
  4. 启动服务:

    nohup java -jar ruoyi-admin.jar > ruoyi.log 2>&1 &
  5. 检查是否启动成功:

    ps aux | grep java
    tail -f ruoyi.log

四、配置 Nginx(反向X_X + HTTPS)

  1. 安装 Nginx

    yum install nginx -y
    systemctl start nginx
    systemctl enable nginx
  2. 上传 SSL 证书(从阿里云下载)

    • 放在 /etc/nginx/cert/
  3. 配置 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

五、微信小程序前端配置

  1. 打开微信开发者工具,导入小程序项目
  2. 修改请求域名:
    • project.config.json 和代码中,将 API 地址改为:
      https://api.yourdomain.com/
  3. 在微信公众平台配置:
    • 登录 mp.weixin.qq.com
    • 开发管理 → 开发设置 → 服务器域名
    • 添加 request 合法域名:https://api.yourdomain.com

⚠️ 注意:微信小程序只允许 HTTPS 请求,且必须备案域名。


六、测试与上线

  1. 启动后端服务,确保接口可访问
  2. 小程序发起登录请求,测试能否正常获取数据
  3. 查看控制台是否有跨域或证书错误
  4. 正式发布小程序

常见问题

问题 解决方案
接口 404 或无法访问 检查防火墙、安全组、Nginx 配置
微信提示域名未备案 必须完成 ICP 备案
SSL 证书无效 确保证书路径正确,浏览器可访问
数据库连接失败 检查 MySQL 是否允许远程连接(若跨服务器)

可选优化

  • 使用 PM2 或 systemd 管理 Java 进程
  • 配置定时备份数据库
  • 使用阿里云 RDS 替代本地 MySQL
  • 添加日志监控(如 ELK)

总结

部署流程:

本地打包 → 上传服务器 → 配置数据库 → 启动后端 → Nginx 反向X_X → 小程序配置域名 → 测试上线

只要确保:

  • 后端服务正常运行
  • 域名备案 + HTTPS
  • 小程序配置正确

即可顺利完成部署。

如需,我可以提供 application.yml 示例、Nginx 配置模板或 shell 启动脚本。

未经允许不得转载:CLOUD云枢 » 若依微信小程序部署到阿里云服务器?