如何在Mac上通过Shell脚本运行Spring Boot Jar包？

以下是你可能遗漏的几个关键点及解决方法：

1. 环境变量的作用域与导出时机 #

脚本中export变量必须在java -jar命令之前执行，否则变量无法被后续的Java进程读取。示例脚本：

#!/bin/bash
# 先导出环境变量，确保路径用引号包裹（避免空格/特殊字符解析错误）
export LOCAL_FILE_PATH="/Users/ABC/Documents/files"
# 验证变量是否正确输出（可选，用于排查）
echo "当前LOCAL_FILE_PATH: $LOCAL_FILE_PATH"
# 再运行Jar包
java -jar your-spring-boot-app.jar

另外，运行脚本时需确保用./run-app.sh（需先执行chmod +x run-app.sh赋予可执行权限），而非sh run-app.sh——后者可能会用不同的Shell（如dash），导致环境变量处理逻辑差异。

2. 路径的引号与转义问题 #

Mac路径中若包含空格、特殊字符（如&、*），必须用双引号或单引号包裹，否则Shell会将空格后的内容解析为新参数。

• 错误写法：export LOCAL_FILE_PATH=/Users/ABC/My Documents/files（变量值仅为/Users/ABC/My）
• 正确写法：export LOCAL_FILE_PATH="/Users/ABC/My Documents/files"

3. Spring Boot配置优先级冲突 #

若你在运行Jar时同时传递了命令行参数（如--local.file.path=xxx），其优先级会高于环境变量，导致环境变量被覆盖。此时需移除对应的命令行参数，确保环境变量生效。

4. spring_boot_json的正确用法 #

使用该参数时，需严格遵循JSON格式，且键名需与配置项对应（支持短横线或驼峰命名，Spring会自动转换）：

# 方式1：用单引号包裹整个JSON字符串
java -jar your-spring-boot-app.jar --spring_boot_json='{"local.file.path":"/Users/ABC/Documents/files"}'
# 方式2：用双引号包裹时，内部双引号需转义
java -jar your-spring-boot-app.jar --spring_boot_json="{\"localFilePath\":\"/Users/ABC/Documents/files\"}"

5. 验证变量是否传递成功 #

在脚本中加入echo命令，或在Spring Boot应用中添加日志输出System.getenv("LOCAL_FILE_PATH")，确认变量是否被正确读取——这能快速定位是脚本问题，还是应用加载配置的问题。

内容的提问来源于stack exchange，提问作者Rahul