AlexStocks opened a new issue, #3793: URL: https://github.com/apache/dubbo-go/issues/3793
## 目标与已知结论 将 #3792 B3/B4/D3/F3 的版本结论和回归材料整理为可公开重放的测试/文档交付。**本任务默认只允许测试、fixture 和文档改动,不授权任何生产修复、依赖升级、backport 或发布。** 定位基线:develop `415f5d17ed0ec451ba8686cd30dfdc508734bba6`。 | 问题 | v3.3.0 | v3.3.1 | v3.3.2 | 已核对 develop | |---|---|---|---|---| | B3:`configVersion < 3.1` 的 enabled/force 读取颠倒 | 存在 | 存在 | 存在 | 已修正(#3773) | | B4:标签路由 Consumer / Provider application 查找不一致 | 存在 | 存在 | 已修正 | 已修正 | 源码标签证据与真实运行结果必须分列,不能把 SourceOnly 写成 RuntimePass。B4 的实现与 #3251 有关,#3772 主要补兼容测试,不能重复归功或再写同一修复。 ## 允许修改什么与复用入口 - `cluster/router/condition/admin_compatibility_test.go`、`dynamic_router_subscribe_test.go`、`admin_config_center_rpc_test.go` 及 `testdata/admin/` 下必要的最小 fixture/README。 - `cluster/router/tag/admin_compatibility_test.go`、`admin_integration_test.go` 及 `testdata/admin/` 下必要的最小 fixture/README。 - 可新增一份集中版本/复现说明;不另造通用 benchmark、跨版本测试平台或第二套 config-center adapter。 - 必须先盘点 #3772/#3773 已有用例。已覆盖的行为只运行并附证据;只有确认缺失时新增测试,不能复制一份同义测试套件。 ## 工作内容 1. 明确 B3 只针对 `configVersion < 3.1`。用真实有效的旧格式规则覆盖 enabled/force 四种组合和字段省略默认值,同时用 `configVersion >= 3.1` 规则作不受相同字段颠倒影响的对照。断言实际选中 Provider 或空结果,不能只断言 parse 不报错。 2. 验证 B4 的 Consumer/Provider 应用名不同场景,覆盖已有 enabled、force/fallback、更新、删除,以及现有 cached/uncached 两种路径;已有用例满足时直接复用。 3. 每个 fixture 记录来源 Admin SHA、writer、资源名、真实 data ID/group 或 ZooKeeper path。捕获的 payload 不得为配合 reader 而改写;手写 YAML 单测必须标注“parser fixture”,不能称 Admin writer 产物。 4. 按正式标签记录 B3/B4 的源码位置和实际运行层级。历史复现使用隔离的标签 checkout,测试 overlay 只改测试文件;旧 API 编译不兼容时记录适配的测试差异或 BLOCKED,不能修历史产品源码后再报告“标签通过”。 5. 整理 v3.3.2 只覆盖 B4、B3 仍需后续正式版本的升级说明。当前任务不决定维护分支支持范围,是否 backport 由维护者另行确定。 ## 禁止事项与必须保留的 harness 边界 - Parser/Router 单测可直接加载规则或调用 `Process`,但只能称本地回归。 - Config-center + RPC 验证必须通过真实 watcher 收到创建/更新/删除事件,并真实调用选中的 Provider;不能在外部测试中手调 `Process`、替换 watcher 或手动刷新状态以使它通过。 - 使用已有 Triple Provider 测试设施;仅本次唯一 application/key、随机或显式隔离端口,清理本次资源,不清空共享 registry。 - 现有治理测试对 ZooKeeper 使用显式 root/namespace 适配;这只能记为 **configured 兼容场景**。默认配置结果另外记录,不能把配置适配后的通过写成默认互操作已修复。 - Admin ZooKeeper group/path 问题已有 [Admin #1625](https://github.com/apache/dubbo-admin/issues/1625) / [#1629](https://github.com/apache/dubbo-admin/issues/1629),治理总需求已有 [Admin #1523](https://github.com/apache/dubbo-admin/issues/1523)。本任务关联实证,不修改 governor、SDK 默认路径或注册模式。 - 根 `go.mod/go.sum`、生产 router、SDK、Admin writer、依赖修复均不在允许范围。若用临时 modfile 做诊断,必须单列为 modified-dependency 控制实验,不能计入原始 SHA 的 PASS。 - 不因网络不可达、依赖 bug、端口冲突而删断言或忽略真实删除;配置了 endpoint 的外部测试不可因连接失败 Skip。 ## 怎么验证对错 自包含用例: ```sh go test ./cluster/router/condition/... ./cluster/router/tag/... -count=1 go test -race ./cluster/router/condition ./cluster/router/tag -count=1 ``` 真实 config center 使用现有 `cluster/router/condition/testdata/admin/compose.yaml`,当前固定 Nacos 2.5.2、ZooKeeper 3.9.4;先检查本地端口可用。以下是 Bash 示例,交付文档提供 PowerShell 等价写法: ```sh DUBBO_GO_CONDITION_NACOS=127.0.0.1:18848 DUBBO_GO_CONDITION_ZK=127.0.0.1:21811 go test ./cluster/router/condition -run '^TestAdminConditionConfigCenterRPC$' -v -count=1 DUBBO_TAG_NACOS=127.0.0.1:18848 DUBBO_TAG_ZOOKEEPER=127.0.0.1:21811 go test -tags adminintegration ./cluster/router/tag -run '^TestAdminTagConfigCenterRPC$' -v -count=1 ``` - 新旧规则结果、实际 watcher 事件、Provider 身份、cached/uncached 断言分别保留。全部 backend 未设置而 Skip 不能视为外部验证通过。 - 历史标签测试以正确路由语义为期望,缺陷应保留失败;不把“断言历史错误行为出现”的绿色观察测试称为产品通过。 - 输出矩阵至少包含:SDK/依赖 SHA、Admin writer SHA、规则格式、default/configured、实际 path/group、用例、SourceOnly/RuntimePass/RuntimeFail/BLOCKED/NOT_RUN、完整命令及退出码。 - 当前分支自包含测试、已启用且具备环境的现有配置场景必须按实际断言判断。环境阻塞不能代替通过;默认路径已有缺陷允许在报告中失败并关联原单,不能用 configured 结果覆盖。 ## 交付、完成标准与人员 - 一份测试/文档 PR:缺失的最小回归、完整规则 YAML、运行命令、版本矩阵、已有问题链接和升级说明。 - harness 的正确性以“真实事件与 Provider 观察、可重放、故障不吞掉”为准;历史版本的预期缺陷和默认配置失败如实保留。交付完成不意味着历史缺陷、backport 或默认路径问题已经修复。 - 不重复实现 #3772/#3773,不在本子任务合并或发布版本。 - 负责人:Go 测试/治理 1 人;与 Admin 四个子任务没有生产文件交叉,可独立进行。 ## 接手与提交约束 - 本任务从审计总单 [Dubbo-Go #3792](https://github.com/apache/dubbo-go/issues/3792) 拆出。首次修改前,记录目标仓库实际 Base/Head SHA,重读总单及本任务关联 PR 的当前状态;以下固定源码用于定位,不能假定接手时的 develop 未变化。 - 生产代码与测试 harness 的权限以本 Issue 为准。发现超出允许范围的问题,提交最小复现和关联阻塞项;不得通过改依赖、改协议、改测试期望或隐式降级扩大范围。 - 使用独立分支/工作区,保留其他人的修改。PR 仅关闭本子任务,不能使用 `Fixes apache/dubbo-go#3792` 或关闭 [功能总单 #3742](https://github.com/apache/dubbo-go/issues/3742)。 - 交付记录必须包含:实际改动路径、Base/Head SHA、完整命令、退出码、断言结果、跳过项和阻塞项。测试 PASS、产品 FAIL、环境 BLOCKED、未执行 NOT_RUN 分开记录;不能用“命令退出 0”替代实际断言。 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
