WireDoctor：Spring Boot 启动和 Bean 循环分析器
内容提要
WireDoctor 是一款零侵入式 Spring Boot 诊断工具，通过分析应用上下文生成交互式报告，帮助解决启动慢、升级后配置失效、循环依赖和“僵尸”Bean 等问题。它支持 CI 门禁检测架构回归，并明确限制：不支持 GraalVM 原生镜像，部分检测为启发式结果。
延伸解读
零侵入与真实数据
WireDoctor 强调零侵入，只需添加依赖即可运行，无需修改业务代码。它读取的是 Spring 应用启动后真实的 ApplicationContext，而非源码定义，因此能反映实际注入的依赖关系和 Bean 的实例化时间。这种基于真实运行数据的分析，比静态代码检查更准确，有助于定位启动慢、循环依赖等实际问题。
CI 门禁的实用价值
WireDoctor 不仅提供诊断报告，还能作为 CI 流水线的门禁，通过基线文件检测架构回归、升级后自动配置变化和性能退化。这意味着团队可以在 PR 阶段自动拦截新增的循环依赖或启动时间显著增加，避免问题流入生产环境。这种将诊断工具集成到开发流程的做法，有助于保持应用健康。
局限性与启发式结果
WireDoctor 明确不支持 GraalVM 原生镜像，在原生镜像中会自动跳过分析。同时，部分检测结果是启发式的，例如“孤儿 Bean”可能通过 ApplicationContext.getBean() 动态调用而实际被使用，循环依赖检测也可能漏报通过三级缓存解决的场景。因此，使用时应结合人工审查，避免完全依赖工具结论。
Q&A
WireDoctor 是什么？它主要解决 Spring Boot 的哪些问题？
WireDoctor 是一个零侵入式的 Spring Boot 诊断工具，通过分析应用上下文生成交互式报告，主要解决启动慢、升级后配置失效、循环依赖和“僵尸”Bean 等问题。
WireDoctor 如何帮助诊断 Spring Boot 启动慢的问题？
WireDoctor 会分析启动过程中每个 Bean 的真实实例化时间，对慢 Bean 进行排序，计算关键路径，并建议通过 @Lazy 优化哪个 Bean 收益最大。
WireDoctor 如何检测 Spring Boot 升级后自动配置失效的问题？
WireDoctor 可以对比不同构建版本中 Spring Boot 的条件报告，在 CI 中捕获 matched 到 notMatched 的转变，从而在升级后及时发现自动配置不再匹配的问题。
WireDoctor 如何检测循环依赖？它有什么局限性？
WireDoctor 能检测出被 Spring 悄悄解决的循环依赖，并通过 lazySuggestions 给出修复建议。但它只能检测“已解决”的循环依赖，对于导致应用崩溃的循环依赖无法报告，且部分通过三级缓存解决的循环依赖可能漏报。
WireDoctor 如何识别“僵尸”Bean？
WireDoctor 通过交叉三个信号来识别那些消耗启动时间和内存但没有使用迹象的 Bean，并诚实标记，不夸大其词。
WireDoctor 生成哪些报告文件？它们有什么特点？
WireDoctor 生成 wiredoctor-report.html 和 wiredoctor-report.json 文件。HTML 报告完全离线可用，包含总览、依赖图、性能、条件等多个标签页；JSON 文件用于 CI 集成。
WireDoctor 如何作为 CI 门禁使用？
WireDoctor 支持三种门禁：架构回归门禁（新增循环依赖时构建失败）、升级门禁（检测自动配置条件变化）、性能门禁（启动时间显著回归或新增慢 Bean 时构建失败）。
WireDoctor 支持 GraalVM 原生镜像吗？
不支持。在原生镜像中运行时，WireDoctor 会自动跳过分析。
