步骤三:提取并修改目标文件
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 检查归档。上线后按项目的发布流程检查服务,必要时换回原包。
- 应急改动要补回正式版本。 事后把改动同步到构建或发布配置,下次发包时一并带上。
技术参考: