springboot项目jar包启动, 配置文件外置

在Spring Boot中,将配置文件外置有多种方式,以下是常见的几种方法:

1. 命令行参数指定配置文件

bash 复制代码
java -jar app.jar --spring.config.location=/path/to/application.properties

或指定多个配置文件:

bash 复制代码
java -jar app.jar --spring.config.location=/path/to/application.properties,/path/to/application-dev.yml

2. 指定配置文件目录

bash 复制代码
# 会加载该目录下的所有配置文件
java -jar app.jar --spring.config.location=file:/config/

3. 使用外部配置文件优先级顺序

Spring Boot按以下顺序加载配置(优先级从高到低):

  1. 命令行参数

  2. 当前目录下的 /config 子目录

  3. 当前目录

  4. classpath下的 /config

  5. classpath根目录

4. 推荐的项目结构

复制代码
project-root/
├── app.jar                    # 打包后的jar文件
├── config/                    # 外部配置文件目录(优先级最高)
│   ├── application.yml
│   ├── application-dev.yml
│   └── application-prod.yml
└── application.yml           # 当前目录下的配置文件

5. 实际部署示例

创建部署脚本 start.sh

bash 复制代码
#!/bin/bash

# 应用名称
APP_NAME="your-app.jar"
# 配置文件目录
CONFIG_DIR="/app/config"
# 日志目录
LOG_DIR="/app/logs"

# 创建目录
mkdir -p ${CONFIG_DIR}
mkdir -p ${LOG_DIR}

# 启动应用
java -jar ${APP_NAME} \
    --spring.config.location=file:${CONFIG_DIR}/ \
    --logging.file.path=${LOG_DIR} \
    --server.port=8080

7. Windows系统启动

bash 复制代码
@echo off
java -jar app.jar --spring.config.location=file:.\config\

9. Spring Boot 2.4+ 配置新特性

使用 application.ymlapplication-{profile}.yml 组合:

bash 复制代码
# application.yml
spring:
  config:
    import:
      - optional:file:./config/[optional-file.properties]
      - optional:file:./config/custom-config.yml

10. 生产环境最佳实践

bash 复制代码
#!/bin/bash
# start-prod.sh

JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
CONFIG_PATH="/opt/app/config"
LOG_PATH="/opt/app/logs"

nohup java ${JAVA_OPTS} \
    -jar app.jar \
    --spring.config.location=file:${CONFIG_PATH}/ \
    --spring.profiles.active=prod \
    --logging.file.path=${LOG_PATH} \
    > ${LOG_PATH}/console.log 2>&1 &

注意事项

  1. 路径格式

    • Linux/Mac: file:/absolute/path/file:./relative/path/

    • Windows: file:C:/path/file:./path/

  2. 多配置文件:使用逗号分隔多个路径

  3. 配置加密:敏感信息建议使用加密配置或使用配置中心

选择适合你部署环境的方式,通常推荐使用独立的config目录来管理配置文件。

相关推荐
llz_1128 小时前
web-第四次课后作业
前端·spring boot·web
一杯奶茶¥9 小时前
基于springboot的失物招领管理系统带万字文档 校园失物招领管理系统 失物认领管理系统java springboot vue
java·vue.js·spring boot·java项目
不能只会打代码9 小时前
边缘视频分析平台的架构设计与性能优化——从750ms到190ms的调优之路
java·spring boot·redis·性能优化·边缘计算·物联网竞赛
东风破13710 小时前
达梦数据库实战:备份恢复与数据迁移全攻略(实例初始化、服务注册、路径迁移)
数据库·chrome
A_humble_scholar12 小时前
Linux(九) 进程管理完全指南:从入门到实战
linux·运维·chrome
雨辰AI13 小时前
生产级实测:SpringBoot3 + 达梦数据库接口从 200ms 优化至 20ms 完整调优指南
java·数据库·spring boot·后端·政务
砍材农夫16 小时前
物联网实战|Spring Boot + Netty 搭建 MQTT 消息路由与流转层
java·spring boot·后端·物联网·spring
lazy H17 小时前
Spring Boot 项目如何连接 Redis?新手入门配置和常见错误总结
ide·spring boot·redis·后端·学习·intellij-idea
cypking17 小时前
从零搭建 Claude Code + Chrome MCP 浏览器自动化:前端 E2E 端到端测试完整教程(包含增量测试)
前端·chrome·自动化
SXJR17 小时前
spring boot + langchain4j +milvus实现向量存储
java·spring boot·后端·大模型·milvus·rag·langchain4j