本文介绍如何在 Gradle 构建的 Java 项目中，为第三方依赖（如 OkHttp）自动下载并关联源码，从而在 jdb 调试器中实现 step into 依赖方法、使用 list 命令查看其源码。核心在于配置源码下载 + 正确设置 jdb -sourcepath。
本文介绍如何在 gradle 构建的 java 项目中，为第三方依赖（如 okhttp）自动下载并关联源码，从而在 `jdb` 调试器中实现 `step into` 依赖方法、使用 `list` 命令查看其源码。核心在于配置源码下载 + 正确设置 `jdb -sourcepath`。
Gradle 默认仅下载依赖的二进制 JAR（.jar），不包含源码（-sources.jar）。而 jdb 要实现源码级调试（如 step 进入 OkHttpClient.newCall()、list 显示 OkHttp 内部代码），必须显式提供对应依赖的源码路径，并通过 -sourcepath 参数告知调试器。
✅ 正确做法：禁用过时插件，改用 Gradle 原生机制下载源码
你当前使用的 io.spring.dependency-management 插件（v1.1.0）主要用于 Spring Boot 的 BOM 版本管理，并不负责下载源码——它无法自动拉取 okhttp-4.9.0-sources.jar。应改用 Gradle 内置的 idea 或 eclipse 任务（即使不用 IDE），或直接声明 sources 配置：
// build.gradle（推荐精简写法）
plugins {
id 'java'
}
repositories {
mavenCentral()
}
dependencies {
implementation 'com.squareup.okhttp3:okhttp:4.9.0'
}
// ✅ 关键：强制下载所有依赖的 sources JAR
configurations.all {
resolutionStrategy {
// 启用源码下载（Gradle 7.0+ 默认启用；旧版本需显式配置）
activateDependencyLocking()
}
}
// 可选：添加 task 快速下载（兼容所有 Gradle 版本）
task downloadSources(type: Copy) {
from configurations.compileClasspath.resolve()
.collect { it.toString().replace('.jar', '-sources.jar') }
.findAll { file(it).exists() }
into "$buildDir/sources"
eachFile { f -> f.path = f.name }
includeEmptyDirs = false
}但更可靠、跨版本通用的方式是直接执行 Gradle 的 idea 或 eclipse 任务（它们会自动解析并下载 sources）：
# 下载所有依赖（含 sources 和 javadoc） ./gradlew idea # 或 ./gradlew eclipse # 或手动触发 sources 下载（推荐） ./gradlew dependencies --configuration compileClasspath # 然后检查 ~/.gradle/caches/.../okhttp-4.9.0/ 目录下是否存在 okhttp-4.9.0-sources.jar
? 验证源码是否就位
运行以下命令确认 okhttp 源码已下载：
find ~/.gradle/caches -name "okhttp-4.9.0-sources.jar" | head -1 # 输出类似：~/.gradle/caches/modules-2/files-2.1/com.squareup.okhttp3/okhttp/4.9.0/xxx/okhttp-4.9.0-sources.jar
⚙️ 启动 jdb 并指定 sourcepath
假设你的主类为 App.java，且已编译完成（./gradlew classes），按如下步骤操作：
# 1. 获取所有依赖 JAR 及 sources JAR 的路径（Linux/macOS）
SOURCE_JARS=$(find ~/.gradle/caches -name "*-sources.jar" | paste -sd ":" -)
DEP_JARS=$(./gradlew -q dependencies --configuration runtimeClasspath | grep -E '\.jar' | awk '{print $2}' | paste -sd ":" -)
# 2. 启动 jdb（注意：sourcepath 必须包含项目源码根目录 + 所有 sources JAR）
jdb -sourcepath "src/main/java:$SOURCE_JARS" \
-classpath "$DEP_JARS:build/classes/java/main" \
App? 关键参数说明：
- -sourcepath：必须包含 src/main/java（你的代码）和所有 -sources.jar 路径（用 : 分隔），jdb 才能定位到 OkHttp 的 .java 文件；
- -classpath：确保运行时类路径完整（含依赖 JAR 和你自己的 class 文件）；
- 若使用 Windows，请将 : 替换为 ;，并用 PowerShell 或 cmd 调整路径拼接逻辑。
? 替代方案：使用 IntelliJ IDEA / VS Code（更高效）
虽然 jdb 是命令行利器，但现代开发中更推荐：
- 在 IDEA 中右键依赖 → Download Sources，然后直接 F7 步入；
- 或用 VS Code + Java Extension Pack，自动索引源码并支持断点调试。
⚠️ 注意事项：
- 并非所有 Maven 仓库都发布 -sources.jar（极少数开源库可能缺失），此时 jdb 无法显示源码，仅能反编译字节码（需额外工具）；
- jdb 不支持自动解压 -sources.jar，务必确保 -sourcepath 中路径指向 JAR 文件本身（而非解压后的目录）；
- 若 list 仍报 No source found for ...，请检查 jdb 启动时的 sourcepath 是否遗漏了 src/main/java —— 缺失会导致连你自己代码都无法 list。
通过以上配置，你即可在 jdb 中对 OkHttpClient 等依赖代码执行 step, next, list 等操作，真正实现全链路源码级调试。
