yudaocode/ruoyi-vue-pro：配置文件详解

【免费下载链接】ruoyi-vue-pro 🔥 官方推荐 🔥 RuoYi-Vue 全新 Pro 版本，优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序，支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、AI 等功能。你的 ⭐️ Star ⭐️，是作者生发的动力！ 项目地址: https://gitcode.com/yudaocode/ruoyi-vue-pro

还在为复杂的Spring Boot项目配置而头疼？本文将深入解析ruoyi-vue-pro项目的配置文件体系，助你快速掌握企业级项目的配置管理精髓！

配置文件体系概览

ruoyi-vue-pro采用多环境、模块化的配置文件设计，主要包含以下核心配置文件：

核心配置文件详解

1. 主配置文件 (application.yaml)

主配置文件定义了项目的全局配置，采用YAML格式，支持多文档块（---分隔）：

spring:
  application:
    name: yudao-server
  profiles:
    active: local  # 激活的环境配置

1.1 数据库配置

spring:
  datasource:
    dynamic:
      primary: master
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/ruoyi-vue-pro
          username: root
          password: 123456

1.2 Redis配置

spring:
  redis:
    host: 400-infra.server.iocoder.cn
    port: 6379
    database: 1

1.3 MyBatis Plus配置

mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true
  global-config:
    db-config:
      id-type: NONE  # 智能模式，自动适配数据库类型
      logic-delete-value: 1
      logic-not-delete-value: 0

2. 开发环境配置 (application-dev.yaml)

开发环境专用配置，包含详细的数据库连接池、监控等配置：

spring:
  datasource:
    druid:
      web-stat-filter:
        enabled: true
      stat-view-servlet:
        enabled: true
        url-pattern: /druid/*

连接池配置详解

druid:
  initial-size: 5        # 初始连接数
  min-idle: 10           # 最小连接池数量
  max-active: 20         # 最大连接池数量
  max-wait: 60000        # 获取连接超时时间(毫秒)
  time-between-eviction-runs-millis: 60000  # 检测间隔

3. 本地环境配置 (application-local.yaml)

本地开发环境配置，通常包含本地服务的地址和端口：

server:
  port: 48080

多环境配置策略

ruoyi-vue-pro支持完善的多环境配置机制：

环境	配置文件	主要用途
本地开发	application-local.yaml	本地开发调试
开发环境	application-dev.yaml	开发团队共享环境
生产环境	application-prod.yaml	正式生产环境

通过spring.profiles.active参数切换环境：

java -jar app.jar --spring.profiles.active=prod

芋道自定义配置

项目扩展了大量自定义配置项，统一在yudao命名空间下：

4.1 安全配置

yudao:
  security:
    permit-all_urls:
      - /admin-api/mp/open/**
  api-encrypt:
    enable: true
    algorithm: AES
    request-key: 52549111389893486934626385991395

4.2 多租户配置

yudao:
  tenant:
    enable: true
    ignore-urls:
      - /jmreport/*
    ignore-tables: []

4.3 AI大模型配置

spring:
  ai:
    openai:
      api-key: sk-aN6nWn3fILjrgLFT0fC4Aa60B72e4253826c77B29dC94f17
      base-url: https://api.gptsapi.net

消息队列配置

支持多种消息队列中间件，配置示例：

5.1 RocketMQ配置

rocketmq:
  name-server: 127.0.0.1:9876
  producer:
    group: ${spring.application.name}_PRODUCER

5.2 Kafka配置

spring:
  kafka:
    bootstrap-servers: 127.0.0.1:9092
    producer:
      acks: 1
      retries: 3

构建配置 (pom.xml)

Maven构建配置文件定义了项目依赖和构建过程：

6.1 项目基本信息

<groupId>cn.iocoder.boot</groupId>
<artifactId>yudao</artifactId>
<version>${revision}</version>
<packaging>pom</packaging>

6.2 模块化管理

<modules>
    <module>yudao-dependencies</module>
    <module>yudao-framework</module>
    <module>yudao-server</module>
    <module>yudao-module-system</module>
    <!-- 更多模块... -->
</modules>

6.3 注解处理器配置

<annotationProcessorPaths>
    <path>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-configuration-processor</artifactId>
    </path>
    <path>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </path>
    <path>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
    </path>
</annotationProcessorPaths>

配置最佳实践

7.1 环境隔离原则

• 本地配置：开发人员个性化配置
• 开发配置：团队共享配置
• 生产配置：线上环境专用配置

7.2 安全配置管理

• 敏感信息使用环境变量或配置中心
• 不同环境使用不同的密钥
• 定期轮换加密密钥

7.3 性能调优配置

spring:
  datasource:
    druid:
      # 连接池优化
      max-active: 50           # 根据实际负载调整
      min-idle: 10
      max-wait: 10000
      
      # 监控配置
      filter:
        stat:
          log-slow-sql: true
          slow-sql-millis: 1000

常见问题排查

8.1 配置加载顺序问题

Spring Boot配置加载顺序：

1. 命令行参数
2. SPRING_APPLICATION_JSON
3. ServletConfig初始化参数
4. ServletContext初始化参数
5. JNDI属性
6. Java系统属性
7. 操作系统环境变量
8. application-{profile}.yml
9. application.yml

8.2 多数据源配置注意事项

# 必须排除Druid自动配置
spring:
  autoconfigure:
    exclude:
      - com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure

总结

ruoyi-vue-pro的配置文件体系体现了企业级项目的典型设计思路：

1. 模块化设计：按功能模块划分配置
2. 环境隔离：支持多环境独立配置
3. 扩展性强：自定义配置命名空间
4. 安全可靠：敏感信息安全管理
5. 性能优化：连接池和缓存配置优化

通过深入理解这些配置文件，你能够：

• ✅ 快速搭建开发环境
• ✅ 灵活切换不同环境
• ✅ 优化系统性能参数
• ✅ 保障系统安全稳定
• ✅ 扩展自定义功能配置

掌握ruoyi-vue-pro的配置体系，将为你的企业级应用开发奠定坚实基础！

【免费下载链接】ruoyi-vue-pro 🔥 官方推荐 🔥 RuoYi-Vue 全新 Pro 版本，优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序，支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、AI 等功能。你的 ⭐️ Star ⭐️，是作者生发的动力！ 项目地址: https://gitcode.com/yudaocode/ruoyi-vue-pro