RuoYi-Cloud SSO单点登录架构深度解析

2026-02-04 05:20:36作者：董灵辛Dennis

痛点场景：多系统登录的困扰

在企业级应用开发中，用户往往需要访问多个独立的业务系统。传统模式下，每个系统都需要单独登录，导致：

🔐 重复输入账号密码，用户体验差
🔄 登录状态无法共享，频繁跳转登录页
⚠️ 安全风险增加，多个系统维护多套认证机制
📊 用户行为难以统一追踪和分析

RuoYi-Cloud基于Spring Cloud Alibaba的分布式微服务架构，提供了完整的SSO（Single Sign-On，单点登录）解决方案，彻底解决上述痛点。

SSO核心架构设计

整体架构图

flowchart TD
    A[用户浏览器] --> B[网关层 Nginx]
    B --> C[API网关 Spring Cloud Gateway]
    C --> D{认证检查}
    
    D -- 已认证 --> E[业务微服务]
    D -- 未认证 --> F[认证中心 Auth Service]
    
    F --> G[Redis Token存储]
    F --> H[用户服务]
    
    E --> I[权限校验]
    I --> J[数据访问]
    
    subgraph 认证域
        F
        G
        H
    end
    
    subgraph 业务域
        E
        I
        J
    end

技术栈组成

组件	技术实现	职责说明
认证中心	Spring Boot + JWT	统一身份认证和令牌发放
API网关	Spring Cloud Gateway	请求路由和认证拦截
Token服务	Redis + JWT	令牌存储和验证
用户服务	Feign Client	用户信息远程调用

核心实现机制

1. 令牌生成与存储

// TokenService.java - 令牌创建核心逻辑
public Map<String, Object> createToken(LoginUser loginUser) {
    String token = IdUtils.fastUUID();
    loginUser.setToken(token);
    refreshToken(loginUser);

    // JWT存储关键信息
    Map<String, Object> claimsMap = new HashMap<>();
    claimsMap.put(SecurityConstants.USER_KEY, token);
    claimsMap.put(SecurityConstants.DETAILS_USER_ID, userId);
    claimsMap.put(SecurityConstants.DETAILS_USERNAME, userName);

    Map<String, Object> rspMap = new HashMap<>();
    rspMap.put("access_token", JwtUtils.createToken(claimsMap));
    rspMap.put("expires_in", TOKEN_EXPIRE_TIME);
    return rspMap;
}

2. 分布式会话管理

sequenceDiagram
    participant User
    participant Gateway
    participant AuthService
    participant Redis
    participant BusinessService

    User->>Gateway: 请求业务接口
    Gateway->>Gateway: 提取Token
    Gateway->>AuthService: 验证Token有效性
    AuthService->>Redis: 查询Token对应会话
    Redis-->>AuthService: 返回用户信息
    AuthService-->>Gateway: 验证结果
    Gateway->>BusinessService: 转发请求(携带用户上下文)
    BusinessService-->>Gateway: 业务响应
    Gateway-->>User: 最终结果

3. 安全校验流程

// 网关层统一认证拦截
@Component
public class AuthFilter implements GlobalFilter {
    
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        String token = extractToken(exchange.getRequest());
        if (StringUtils.isEmpty(token)) {
            return unauthorizedResponse(exchange);
        }
        
        // 调用认证服务验证Token
        Boolean isValid = authService.validateToken(token);
        if (!isValid) {
            return unauthorizedResponse(exchange);
        }
        
        // 将用户信息添加到请求头
        ServerHttpRequest newRequest = exchange.getRequest().mutate()
                .header("X-User-Id", getUserId(token))
                .header("X-User-Name", getUserName(token))
                .build();
                
        return chain.filter(exchange.mutate().request(newRequest).build());
    }
}

关键配置详解

Redis令牌存储配置

# application.yml 关键配置
spring:
  redis:
    host: ${REDIS_HOST:localhost}
    port: ${REDIS_PORT:6379}
    password: ${REDIS_PASSWORD:}
    database: 0
    timeout: 3000ms

# Token相关常量配置
cache:
  expiration: 720    # Token有效期(分钟)
  refresh-time: 120  # 刷新阈值(分钟)
  login-token-key: "login_tokens:"  # Redis键前缀

JWT密钥配置

# JWT签名密钥配置
jwt.secret=your-jwt-secret-key-here
jwt.expiration=43200000  # 12小时
jwt.token-header=Authorization
jwt.token-prefix=Bearer

实战部署指南

1. 环境准备要求

组件	版本要求	说明
JDK	1.8+	推荐JDK 11
Redis	5.0+	会话存储
Nacos	2.0+	服务发现和配置中心
MySQL	5.7+	业务数据存储

2. 部署步骤

# 1. 克隆项目
git clone https://gitcode.com/yangzongzhuan/RuoYi-Cloud

# 2. 导入数据库脚本
mysql -uroot -p < sql/ry_20250523.sql

# 3. 修改配置文件
# 配置Redis、MySQL连接信息
# 设置JWT签名密钥

# 4. 启动基础服务
docker-compose up -d mysql redis nacos

# 5. 编译并启动微服务
mvn clean package -DskipTests
java -jar ruoyi-auth/target/ruoyi-auth.jar
java -jar ruoyi-gateway/target/ruoyi-gateway.jar

# 6. 启动前端服务
cd ruoyi-ui
npm install
npm run dev

3. 性能优化建议

# 网关层性能优化配置
spring:
  cloud:
    gateway:
      httpclient:
        connect-timeout: 1000
        response-timeout: 5s
      default-filters:
        - name: RequestRateLimiter
          args:
            redis-rate-limiter.replenishRate: 10   # 每秒令牌数
            redis-rate-limiter.burstCapacity: 20   # 突发容量

安全最佳实践

1. 令牌安全策略

策略	实现方式	安全等级
HTTPS传输	强制SSL加密	🔴🔴🔴🔴🔴
Token过期	短期有效期+自动刷新	🔴🔴🔴🔴⚪
黑名单机制	Redis存储失效Token	🔴🔴🔴⚪⚪
访问频率限制	网关层限流	🔴🔴🔴⚪⚪

2. 防重放攻击

// 防止Token重放攻击
public boolean isTokenReplayed(String token, String requestId) {
    String key = "replay:" + token + ":" + requestId;
    Boolean exists = redisTemplate.hasKey(key);
    if (exists != null && exists) {
        return true; // 请求重复
    }
    redisTemplate.opsForValue().set(key, "1", 5, TimeUnit.MINUTES);
    return false;
}

故障排查指南

常见问题及解决方案

问题现象	可能原因	解决方案
Token验证失败	Redis连接异常	检查Redis服务状态和网络连通性
登录后跳转404	网关路由配置错误	验证网关路由规则和服务注册
权限校验失败	用户角色配置问题	检查用户角色和权限映射关系
性能响应慢	Redis或数据库瓶颈	监控系统资源使用情况

监控指标设置

# 建议监控的关键指标
management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  metrics:
    tags:
      application: ${spring.application.name}
    export:
      prometheus:
        enabled: true