Repository navigation
Troubleshooting
首页 · Discussions 原始记录 · 版本与升级
按“版本 → 构建 → 直连 → 发现 → 治理”的顺序缩小范围。以下是本次整理的排查建议，不把任何单个历史讨论当作所有版本通用的修复结论。
记录 Go、Dubbo-go、生成器、Java Dubbo（如涉及）的版本，以及 registry／配置中心的产品和版本；保留 go.mod、启动命令、配置路径、最小 proto、完整错误和可复现步骤。敏感凭据从复现资料中去除。
| 现象 | 先检查 | 继续阅读 |
|---|---|---|
| 安装或编译失败 | 目标 tag 的 Go 指令、模块路径、生成器和 stub 是否匹配 | 版本与升级、工具链 |
| 导入 config 后无法编译 | 是否升级到了删除旧 config 包的版本 | 迁移检查 |
| YAML 不生效 | 进程的 DUBBO_GO_CONFIG_PATH、启动目录、实际读取文件 | 配置 |
| 直连失败 | provider 是否启动，监听地址和端口、协议、服务名、方法名是否一致 | RPC 教程 |
| 注册中心有实例却无法发现 | interface/service/all 模式，服务到应用映射、metadata、group/version | 应用级发现 |
| Nacos 升级后异常 | SDK 与服务端版本、鉴权、namespace，以及注册／配置／metadata 三条链路 | Nacos 升级方案 |
| 请求超时或重试次数不符 | client／服务／调用三级配置和 Cluster 策略，服务端处理耗时 | 超时、重试 |
| Java 互通失败 | 协议、IDL、序列化、服务名／方法名、group/version 与发现模式 | 跨语言教程 |
| attachments 或 tracing 信息丢失 | 发送／读取位置、header／trailer API、目标版本修复记录 | 上下文传递、CHANGELOG |
| 退出时仍有流量或请求中断 | 探针、摘流、进行中的请求和退出等待是否协调 | 治理与运维 |
#2756 是一个已关闭且有已采纳答案的问答，原始环境为 Go client v3.2.0-rc2、Java server v3.3.0、ZooKeeper。讨论包含 Receive 阻塞、EOF、连接增长和复用 generated service 的最小实验。排查时应把流的结束、底层连接存活、client 对象和 service 对象的生命周期分开观察。
该讨论的采纳状态不能证明所有新版本中的类似症状都已修复。先用自己的版本复现，再核对 流式调用手册 与发布说明。
#2764 提供泛化调用场景的复现与引用分析思路，并记录关联 issue 和评论。它在本次快照中仍为打开状态，无已采纳答案。把它当作定位材料；评论中的工具描述也可能需要核对原工具文档。
建议保存调用次数、对象／连接增长曲线和 profile，区分持续保留与暂时分配。3.3.2 的 CHANGELOG 记录 URL 状态保留与资源清理相关修复，但不能仅凭标题认定与当前现象同因。完整变更
#3673 的后续评论补充了压缩、编码、测试顺序与大报文拷贝成本对结果的影响，部分数据明确标记待更新。复查硬件、Go 版本、提交、并发、报文分布、编码、压缩和测量轮次后，再比较吞吐和延迟。
本 Wiki 不把讨论中的预计收益、单机数字或 早期 benchmark 改写成当前性能承诺。