Skip to main content

配置索引

本章节汇总 SurveyKing Pro MySQL、Redis、MQ、文件存储 等运行时配置,帮助运维与开发快速完成环境部署。

📖 目录

文档作用
环境变量总览完整列举 Spring Boot application*.yml 中所有可配置项,含默认值与说明
数据库配置(计划中)MySQL 8 连接池、读写分离、备份策略
Redis & 消息队列(计划中)Redis 缓存、Redisson 分布式锁、Stream 队列
对象存储(计划中)MinIO / 阿里 OSS 配置示例
第三方集成(计划中)邮件、短信、OAuth2 社交登录配置

若某篇文档显示"计划中",说明功能已支持,文档仍在编写;可参考 server 源码或联系维护者。

⚡ 快速开始

  1. 克隆代码并启动 MySQL 8 & Redis(可用 docker-compose):
docker compose up -d mysql redis
  1. 初始化数据库
mysql -h127.0.0.1 -uroot -p < scripts/init-mysql.sql
  1. 修改本地配置:在 server/surveyking-server/src/main/resources/ 新建/修改 application-dev.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/surveyking?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username: root
password: surveyking
redis:
host: localhost
port: 6379
surveyking:
file:
local-path: ./files
  1. 启动后端:
./mvnw -pl server/surveyking-server -am spring-boot:run
  1. 访问 Swagger: 本地 Swagger

前端请参见 client/README.md 或直接执行:

cd client && pnpm install && pnpm dev

🗺️ 配置文件层级

server/
└── surveyking-server/
└── src/main/resources/
├── application.yml # 公共默认配置
├── application-dev.yml # 开发环境专属
├── application-test.yml # 测试环境专属
└── application-prod.yml # 生产环境专属

Spring Boot 将按照 --spring.profiles.active 读取对应文件并 覆盖 application.yml 中同名属性。

🔑 常用变量速查

默认说明
spring.datasource.urljdbc:mysql://localhost:3306/surveykingMySQL 连接串
spring.redis.hostlocalhostRedis 主机
server.port48080服务端口
surveyking.file.local-path./files本地上传文件存放目录

完整列表请见 环境变量总览


如有配置疑问,欢迎在 GitHub Issue 或企业微信交流群提问。