环境搭建与工具选型：四大工具对比与实战

做数据回放，选对工具就等于成功了一半。我见过不少团队，工具还没摸透就急着上线，结果回放数据对不上，排查问题花了一周。今天咱们就聊聊市面上主流的四款工具：GoReplay、JVM-Sandbox-Repeater、Diffy、Sharingan。我会结合自己的踩坑经历，帮你理清思路。

一、工具横向对比：谁适合你？

先看一张对比表，心里有个底。

工具	核心原理	语言支持	流量劫持方式	回放模式	学习成本
GoReplay	网络层抓包重放	任何HTTP服务	端口镜像/代理	实时/离线	低
JVM-Sandbox-Repeater	Java方法级录制回放	Java（JVM）	字节码增强	单请求回放	中
Diffy	多版本响应对比	任何HTTP服务	代理转发	实时对比	低
Sharingan	Go应用函数级录制	Go	代码注入	离线回放	高

说白了，选工具就是选场景。我个人习惯这样判断：

• GoReplay：适合快速验证，不改代码。我曾在压测环境用它录了5分钟线上流量，直接怼到预发环境，发现了一个隐藏的OOM问题。
• JVM-Sandbox-Repeater：适合Java服务做精准回归。它能录制到方法调用链，连数据库查询都能回放。但要注意，它依赖JVM Sandbox，启动时会有性能损耗。
• Diffy：适合新旧版本对比。部署简单，但只能对比HTTP响应，没法做复杂链路。
• Sharingan：适合Go项目做精细化回放。它能在函数级别mock依赖，但配置起来比较繁琐。

二、GoReplay 环境搭建实战

GoReplay 是我用得最多的工具。它的安装简单到令人发指——就一个二进制文件。

2.1 安装与基础配置

# 下载（以Linux为例）
wget https://github.com/buger/goreplay/releases/download/v1.3.3/gor_1.3.3_amd64.tar.gz
tar -xzf gor_1.3.3_amd64.tar.gz
sudo mv gor /usr/local/bin/

# 验证安装
gor --version

嗯，这里要注意：GoReplay 依赖 libpcap，如果你的系统没有，需要先装一下。

# Ubuntu/Debian
sudo apt-get install libpcap-dev

# CentOS/RHEL
sudo yum install libpcap-devel

2.2 录制与回放

录制线上流量到文件：

# 监听8080端口，保存到文件
sudo gor --input-raw :8080 --output-file requests.gor

回放流量到测试环境：

# 从文件读取，发送到测试环境
gor --input-file requests.gor --output-http "http://test.example.com:8080"

我曾经犯过一个低级错误：回放时没加 --output-http-timeout，结果测试环境响应慢，导致回放进程卡死。后来我习惯加上超时参数：

gor --input-file requests.gor --output-http "http://test.example.com:8080" --output-http-timeout 30s

三、JVM-Sandbox-Repeater 环境搭建

这个工具适合Java项目。它的原理是在JVM层面做字节码增强，录制方法调用和返回值。

3.1 安装Sandbox

# 下载Sandbox
wget https://github.com/alibaba/jvm-sandbox/releases/download/1.4.0/sandbox-1.4.0-bin.zip
unzip sandbox-1.4.0-bin.zip -d /opt/sandbox

# 配置环境变量
export SANDBOX_HOME=/opt/sandbox
export PATH=$PATH:$SANDBOX_HOME/bin

3.2 部署Repeater模块

Repeater 是 Sandbox 的一个插件。你需要先编译它：

git clone https://github.com/alibaba/jvm-sandbox-repeater.git
cd jvm-sandbox-repeater
mvn clean package -DskipTests

# 将编译好的模块复制到Sandbox的模块目录
cp repeater-module/target/repeater-module-*.jar $SANDBOX_HOME/sandbox-module/

3.3 启动与录制

假设你的Java应用已经运行在8080端口：

# 附加Sandbox到目标JVM
sandbox.sh -p 12345 -P 8080

# 启动录制（通过HTTP接口）
curl -X POST http://localhost:8080/sandbox/repeater/module/http/repeat?action=start

这里有个坑：Sandbox 需要目标JVM的PID。如果你不知道PID，可以用 jps -l 查看。我曾经在容器环境里折腾了半天，才发现PID不对——容器内的PID和宿主机不一样。

四、Diffy 与 Sharingan 快速上手

4.1 Diffy：三路对比

Diffy 的思路很巧妙：它把请求同时发给旧版本和新版本，然后对比响应差异。部署很简单：

# 启动Diffy（假设旧版本在9000，新版本在9001）
java -jar diffy-server.jar \
  --candidate=http://localhost:9001 \
  --master.primary=http://localhost:9000 \
  --master.secondary=http://localhost:9000 \
  --service.protocol=http \
  --server.port=8888 \
  --responseMode=primary

然后你把流量指向Diffy的8888端口，它就会自动做对比。我个人觉得Diffy最适合做灰度发布前的验证——把线上流量引一份到新版本，看看有没有异常响应。

4.2 Sharingan：Go应用的利器

Sharingan 是滴滴开源的，专门针对Go应用。它通过代码注入的方式，录制函数的入参和返回值。

# 安装Sharingan
go get github.com/didi/sharingan

# 在你的Go项目中引入
import _ "github.com/didi/sharingan"

# 编译时加上tag
go build -tags "sharingan" -o myapp

录制时，它会自动把函数调用信息写入本地文件。回放时，它会mock掉所有外部依赖（比如数据库、Redis），只使用录制的数据。

五、知识体系总览

下面这张图，帮你理清这四款工具的核心逻辑和适用场景。

六、避坑指南

最后分享几个我踩过的坑，希望能帮你省点时间。

• 流量放大问题：GoReplay 回放时默认会放大流量（因为回放速度可能比录制快）。记得加 --output-http-workers 限制并发。
• 时间戳不一致：录制的请求里可能包含时间戳，回放时会导致签名校验失败。我习惯在回放前用脚本把时间戳替换掉。
• 依赖mock不完整：JVM-Sandbox-Repeater 默认只录制主调方法，子调用可能漏掉。建议先在小流量上验证录制完整性。
• 磁盘空间爆炸：录制文件增长很快。我曾经一个晚上录了200GB。建议设置录制上限，或者用 --output-file-max-size 限制单个文件大小。

可可精品资料库