此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！

PropertiesLauncher具有一些可以使用外部属性（系统属性、环境变量、清单条目或 ）启用的特殊功能。 下表描述了这些属性：loader.properties

钥匙 目的

loader.path

逗号分隔的类路径，例如 . 较早的条目优先，就像命令行上的常规条目一样。lib,${HOME}/app/lib-classpathjavac

loader.home

用于解析 中的相对路径。 例如，给定 ，则是一个类路径位置（以及该目录中的所有 jar 文件）。 此属性还用于查找文件，如以下示例所示 它默认为 。loader.pathloader.path=lib${loader.home}/libloader.properties/opt/app${user.dir}

loader.args

main 方法的默认参数（以空格分隔）。

loader.main

要启动的主类的名称（例如，）。com.app.Application

loader.config.name

属性文件的名称（例如，）。 它默认为 。launcherloader

loader.config.location

属性文件的路径（例如，）。 它默认为 。classpath:loader.propertiesloader.properties

loader.system

Boolean 标志，指示应将所有属性添加到系统属性中。 它默认为 。false

当指定为环境变量或清单条目时，应使用以下名称：

钥匙 清单条目 环境变量

loader.path

Loader-Path

LOADER_PATH

loader.home

Loader-Home

LOADER_HOME

loader.args

Loader-Args

LOADER_ARGS

loader.main

Start-Class

LOADER_MAIN

loader.config.location

Loader-Config-Location

LOADER_CONFIG_LOCATION

loader.system

Loader-System

LOADER_SYSTEM
构建插件会自动将属性移动到构建 uber jar 时。 如果使用它，请使用属性并省略 来指定要启动的类的名称。Main-ClassStart-ClassMain-ClassStart-Class
构建插件会自动将属性移动到构建 uber jar 时。 如果使用它，请使用属性并省略 来指定要启动的类的名称。Main-ClassStart-ClassMain-ClassStart-Class

以下规则适用于使用：PropertiesLauncher

  • loader.properties在 中搜索，然后在类路径的根目录中搜索，然后在 中搜索。 使用具有该名称的文件存在的第一个位置。loader.homeclasspath:/BOOT-INF/classes

  • loader.home仅当未指定时，才是其他属性文件的目录位置（覆盖默认值）。loader.config.location

  • loader.path可以包含目录（以递归方式扫描 jar 和 zip 文件）、归档路径、归档文件中扫描 jar 文件的目录（例如，）或通配符模式（用于缺省 JVM 行为）。 归档路径可以是相对于文件系统或文件系统中带有前缀的任何位置。dependencies.jar!/libloader.homejar:file:

  • loader.path（如果为空）默认为 （表示本地目录或嵌套目录（如果从存档运行）。 因此，其行为与未提供其他配置时的行为相同。BOOT-INF/libPropertiesLauncherJarLauncher

  • loader.path不能用于配置的位置（用于搜索后者的类路径是启动时的 JVM 类路径）。loader.propertiesPropertiesLauncher

  • 占位符替换是在使用之前从系统和环境变量以及所有值的属性文件本身完成的。

  • 属性的搜索顺序（在多个位置查找是有意义的）是环境变量、系统属性、分解存档清单和存档清单。loader.properties