手里只有 JAR 包,怎么修改里面的配置?
手里只有一个 app.jar,里面的配置写错了。包有几百兆,想改的可能只有一行,比如把端口从 8080 改成 9090。
在 Linux 上,可以用 jar 命令把目标文件单独提取出来,改完再按原路径写回。最后用 unzip -p 读出包里的内容,确认改进去的是新值。
通用步骤:保留原包 → 找到配置路径 → 单独提取 → 修改并写回 → 直接读包验证。
01 核心原理:为什么能直接改 JAR?
1. JAR 包里装了什么?
JAR 使用 ZIP 格式,里面可以放 Java 类、配置文件和依赖库。application.yml、application.properties 这样的配置是文本文件,提取出来就能编辑。
常见的 Spring Boot 可执行 JAR 结构如下:
app.jar
├── META-INF/
│ └── MANIFEST.MF
└── BOOT-INF/
├── classes/
│ ├── application.yml
│ ├── application-prod.yml
│ └── com/example/...
└── lib/
├── spring-boot-*.jar
└── 其他依赖.jar
| 路径 | 放的内容 |
|---|---|
META-INF/MANIFEST.MF | 包的信息,例如用 java -jar 启动时的入口 |
BOOT-INF/classes/ | 应用自己的类和资源,包内配置通常在这里 |
BOOT-INF/lib/ | 应用运行依赖的 JAR |
普通 JAR 的目录可能不同。操作时以 jar -tf 查到的路径为准。
2. “写回原路径”是什么意思?
压缩包用完整路径来区分文件。BOOT-INF/classes/application.yml 和包根目录的 application.yml 是两个不同的条目。
提取时,jar -xf 会在当前目录创建对应的目录和文件。改完用 jar -uf 写回时,路径和包内原路径一致,就会替换原来的那份配置。路径写错了,包里可能多出一份配置,原文件仍在原处。
3. 为什么几百兆的包也只提取一个文件?
jar -xf 可以指定要提取的条目。改配置时只需要把那一个文件解到磁盘,其他依赖不用全部解压。写回时,工具仍可能生成一个临时归档,所以处理大包前要给副本和更新操作留出磁盘空间。
02 通用操作:修改 JAR 包内的文本配置
这一节适用于手里只有构建产物、需要改包内文本配置的情况。示例用 Spring Boot 的 application.yml,改 .properties 或其他文本文件时也是这套顺序。
步骤一:保留原包,在副本上操作
先进入一个有写权限、磁盘空间够用的目录。把下面的源路径换成实际文件位置:
df -h .
source_jar=/path/to/app.jar
work_dir=$(mktemp -d "$PWD/jar-config.XXXXXX") &&
cp "$source_jar" "$work_dir/app.jar" &&
cd "$work_dir"
后面的 app.jar 都是工作目录里的副本。原包留在原来的位置,回退时可以直接用。
步骤二:查找包内的配置文件
jar -tf app.jar | grep -E '(^|/)application(-[^/]+)?\.(yml|yaml|properties)$'
例如查到:
BOOT-INF/classes/application.yml
BOOT-INF/classes/application-prod.yml
先确认这次要改哪一份。如果改的是某个环境的配置,按对应文件名选。下面以 application.yml 为例。把路径存到变量里,后面的命令都用同一个值:
entry=BOOT-INF/classes/application.yml
unzip -p app.jar "$entry"
用 unzip -p 先看原始内容,确认找对了文件和配置项。后续命令继续在同一个终端、同一个工作目录执行。
步骤三:提取并修改目标文件
jar -xvf app.jar "$entry"
vi "$entry"
按配置文件的格式改对应的项并保存。YAML 要保留原有缩进;如果同一个值在文件里出现多次,只改这次需要改的那一项。第 03 节会用 sed 演示如何替换练习包里的端口。
步骤四:按原路径写回
jar -uvf app.jar "$entry"
u 表示更新,v 打印过程,f 后面是 JAR 文件名。从提取文件时的工作目录执行这条命令,包内路径就能和原路径对应上。
步骤五:读包验证,保留回退用的原包
unzip -p app.jar "$entry"
unzip -tq app.jar
第一条核对目标配置是不是新值,第二条检查压缩包能否正常读取。想确认包内文件与刚编辑好的文件逐行一致,可以再做一次比较:
unzip -p app.jar "$entry" > packaged-config.txt &&
diff -u "$entry" packaged-config.txt
diff 没有输出,表示两份内容一致。用于生产时,按原有发布流程部署改好的副本,保留原包。需要回退时,用同样的发布流程换回原包。
JAR 有签名校验时,修改签名覆盖的文件会让原签名校验失败。遇到这种包,走重新构建和签名流程。
03 实机故障复现与恢复
1. 准备环境和演示包
打开网站首页,点击顶部的 故障复现素材库,下载本期的 app.jar。
准备一台 Linux 机器。正常流程用 jar、sed、unzip;没有 jar 的机器可以走后面的 ZIP 方案。
mkdir -p ~/jar-config-lab
cd ~/jar-config-lab
把下载好的 app.jar 放进这个目录,再执行:
ls -lh app.jar
command -v jar sed unzip
cp -ip app.jar app.jar.bak
如果提示备份已存在,输入 n 可以保留第一次练习前的原包。这个小型演示包的初始端口是 8080,练习只需要改包和读包。
2. 找到配置,读出原值
jar -tf app.jar | grep application.yml
unzip -p app.jar BOOT-INF/classes/application.yml
实机输出的配置路径:
BOOT-INF/classes/application.yml
修改前的内容:
server:
port: 8080
spring:
application:
name: jar-config-demo
3. 提取配置,用 sed 把端口改成 9090
jar -xvf app.jar BOOT-INF/classes/application.yml
ls BOOT-INF/classes/application.yml
sed -i 's/port: 8080$/port: 9090/' BOOT-INF/classes/application.yml
提取时会看到:
extracted: BOOT-INF/classes/application.yml
sed -i 直接修改提取出来的文件。这里把行尾的 port: 8080 换成 port: 9090,前面的 YAML 缩进会保留。
4. 写回 JAR,再读一次包
jar -uvf app.jar BOOT-INF/classes/application.yml
unzip -p app.jar BOOT-INF/classes/application.yml
更新时实机输出:
adding: BOOT-INF/classes/application.yml(in = 71) (out= 66)(deflated 7%)
验证时直接读的是 JAR 里的文件:
server:
port: 9090
spring:
application:
name: jar-config-demo
看到 port: 9090,说明新的值已经写进包里。本次练习到这里就完成了,无需启动服务。
5. 恢复原包,重新练习
cp -p app.jar.bak app.jar
unzip -p app.jar BOOT-INF/classes/application.yml
看到 port: 8080,说明原包已恢复。再次执行提取命令时,练习目录里的同名配置会被重新解出来。
6. 只有 JRE,没有 jar 命令的做法
准备好 zip 和 unzip。先用上一步恢复原包,再执行:
unzip -Z1 app.jar | grep application.yml
unzip -o app.jar BOOT-INF/classes/application.yml
sed -i 's/port: 8080$/port: 9090/' BOOT-INF/classes/application.yml
zip -u app.jar BOOT-INF/classes/application.yml
unzip -p app.jar BOOT-INF/classes/application.yml
unzip -o 会覆盖当前练习目录下已有的同名文件。zip -u 会比较修改时间。如果已经改好文件,但它没有更新包里的条目,可以用 zip app.jar BOOT-INF/classes/application.yml 替换同路径文件,再读包确认。
04 常用命令速查
| 想做什么 | 命令 |
|---|---|
| 列出包内文件 | jar -tf app.jar |
| 只提取一个包内文件 | jar -xf app.jar BOOT-INF/classes/application.yml |
| 按原路径写回 | jar -uf app.jar BOOT-INF/classes/application.yml |
| 直接查看包里的内容 | unzip -p app.jar BOOT-INF/classes/application.yml |
| 检查压缩包完整性 | unzip -tq app.jar |
| 比较两个包的版本是否一致 | sha256sum old/app.jar new/app.jar |
jar 常用的几个字母也可以拆开记:t 列目录,x 提取,u 更新,v 显示操作过程,f 指定包文件。
05 面试回答:线上只有一个 JAR 包,配置写错了,怎么改?
先保留原包,在副本上用
jar -tf找到配置在包里的路径,再用jar -xf只提取这个文件。改完后用jar -uf按原路径写回,最后用unzip -p核对包里的值。线上要用修改后的包时,按发布流程替换,原包留着回退。
记住这五步:留原包、找路径、提取修改、写回、读包验证。
06 面试追问与回答
Q1:为什么没有源码也能改?
配置文件是 JAR 包里的文本资源。用压缩包工具把这个文件提取出来,再写回同一路径即可。修改 Java 代码则要走代码、编译和发布流程。
Q2:几百兆的包,只改一行也要留额外空间吗?
要预留。操作时只提取这一份配置,但更新工具可能会生成临时包再替换原文件。线上准备副本和备份时,也要把这些空间算进去。
Q3:为什么更新时的相对路径要保持一致?
JAR 按条目路径区分文件。BOOT-INF/classes/application.yml 和包根目录里的 application.yml 是两个条目。写错位置会多出一个文件,原位置上的配置还在。
Q4:没有 jar 命令,还能改吗?
机器装了 zip 和 unzip 就能操作。先用 unzip -Z1 列路径,unzip 提取文件,改完用 zip 写回,再用 unzip -p 读包验证。第 03 节有完整命令。
Q5:配置改完需要重启吗?
Spring Boot 通常在启动时读取包内配置。线上要用改好的包,就按现有发布方式用新包启动或替换实例。第 03 节只验证文件写回,直接读包即可。
Q6:服务是跑在 Docker 或 Kubernetes 里的,怎么处理?
把改好的 JAR 放进新镜像,再按原有流程发布。直接进容器改包,容器重建时会丢掉这次改动。
Q7:unzip -t 检查通过,就可以确认上线成功吗?
它只检查压缩包能否正常读取。包内配置用 unzip -p 看,服务有没有应用新值看日志和实际监听,业务是否恢复再看健康检查和接口。
07 JAR 配置只读检查脚本
这个脚本适合拿到一个陌生的 JAR 时用。默认只列出常见的 Spring Boot 配置文件路径;明确传入某条路径,才会显示它的内容。它只读文件,不修改包。
保存为 inspect-jar-config.sh:
#!/usr/bin/env bash
set -euo pipefail
if (( $# < 1 || $# > 2 )); then
echo "用法:bash $0 app.jar [包内配置路径]" >&2
exit 2
fi
archive=$1
case "$archive" in
/*) ;;
*) archive="./$archive" ;;
esac
if [[ ! -r "$archive" || ! -f "$archive" ]]; then
echo "找不到可读的文件:$archive" >&2
exit 1
fi
if command -v jar >/dev/null 2>&1; then
entries=$(jar -tf "$archive")
elif command -v unzip >/dev/null 2>&1; then
entries=$(unzip -Z1 "$archive")
else
echo "需要 jar 或 unzip 来读取包目录。" >&2
exit 1
fi
if (( $# == 1 )); then
if ! grep -E '(^|/)application(-[^/]+)?\.(yml|yaml|properties)$' <<< "$entries"; then
echo "没有找到常见的 application 配置文件。"
fi
exit 0
fi
entry=$2
if ! grep -Fxq -- "$entry" <<< "$entries"; then
echo "包里没有这条路径:$entry" >&2
exit 1
fi
if ! command -v unzip >/dev/null 2>&1; then
echo "需要 unzip 来显示文件内容。" >&2
exit 1
fi
unzip -p "$archive" "$entry"
用法:
bash inspect-jar-config.sh app.jar
bash inspect-jar-config.sh app.jar BOOT-INF/classes/application.yml
线上配置里可能含密码或令牌。排查记录只摘出需要核对的配置项,别贴整份文件。
08 生产处理要点与技术参考
- 先留原包。 在副本上做改动,备份放在不会被这次操作覆盖的位置。
- 查准路径再写回。 提取、更新、验证用同一条包内路径。遇到大包,提前确认工作目录有足够的磁盘空间。
- 先验证包,再发布。 用
unzip -p核对内容,用unzip -tq检查归档。上线后按项目的发布流程检查服务,必要时换回原包。 - 应急改动要补回正式版本。 事后把改动同步到构建或发布配置,下次发包时一并带上。
技术参考: