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目录来管理配置文件。

相关推荐
凤山老林4 小时前
Spring Boot 3.x AOT 编译实战:从原理、踩坑到生产落地
java·spring boot·后端
摇滚侠5 小时前
《SpringBoot 3:入门与应用实战》第 5 章 使用 Spring Boot 阅读笔记 9
java·spring boot·笔记
wno70410 小时前
Spring Boot中使用Servlet
spring boot·后端·servlet
MetaLite10 小时前
SpringBoot异常处理-到底该转换还是继续抛-入口层与调用层不能一刀切
java·spring boot·后端
摇滚侠12 小时前
《SpringBoot 3:入门与应用实战》第 6 章 Spring Boot 最佳实践 阅读笔记 10
java·spring boot·笔记
摇滚侠14 小时前
《SpringBoot 3:入门与应用实战》第 6 章 Spring Boot 最佳实践 阅读笔记 11
spring boot·笔记·后端
程序员贺加贝16 小时前
业务操作日志不是字段审计:快照 Diff、幂等账本与业务语义建模
spring boot·架构
evans在进步16 小时前
Spring Boot 核心机制详解:自动装配、事件监听、异步任务与请求映射
java·spring boot·后端
梦想blog17 小时前
Claude Code + Chrome MCP:让浏览器自动化测试更简单
前端·chrome·自动化·mcp
骇客野人17 小时前
SpringBoot 接入 Kafka 完整实操步骤
spring boot·kafka·linq