跳到主要内容

手里只有 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 检查归档。上线后按项目的发布流程检查服务,必要时换回原包。
  • 应急改动要补回正式版本。 事后把改动同步到构建或发布配置,下次发包时一并带上。

技术参考: