GoFrame项目必须使用v2版本Apollo适配器，即github.com/gogf/gf/contrib/config/apollo/v2，NamespaceName需逗号无空格分隔，Secret不能为空字符串，IP不可带http://前缀，配置变更需调用g.Cfg().Watch()并手动刷新业务逻辑，且Portal中须点击“发布”才生效。
Go 项目能直接对接 Apollo，但必须用官方适配器，不能靠裸 HTTP 调用或自己轮询。
go get 的包名必须带 v2 后缀
GoFrame 官方维护的 Apollo 适配器路径是 github.com/gogf/gf/contrib/config/apollo/v2，不是 v1 或无版本号。用错版本会导致编译失败或监听失效。
- 正确命令：
go get github.com/gogf/gf/contrib/config/apollo/v2 - 错误示例：
go get github.com/gogf/gf/contrib/config/apollo（缺/v2） - 如果项目已用
gf/v2，但 Apollo 包没加/v2，g.Cfg().Get()可能返回空值，且无报错提示
NamespaceName 必须用英文逗号分隔，不能有空格
Apollo 支持多命名空间，但 Go 客户端对格式敏感。写成 "application, user-service"（带空格）会导致第二个命名空间加载失败，只生效第一个。
- 正确写法：
NamespaceName: "application,user-service" - 错误写法：
NamespaceName: "application, user-service"或["application", "user-service"]（切片不被支持） - 若某个命名空间不存在，客户端不会报错，但对应配置读不到——建议在 Portal 先确认命名空间已创建并发布过配置
Secret 不是可选字段，即使没开启权限验证也要填空字符串
Apollo 默认关闭鉴权，但 Go 客户端 SDK 强制校验 Secret 字段非空。跳过会 panic：secret cannot be empty。
立即学习“go语言免费学习笔记（深入）”；
- 未启用鉴权时，填
Secret: ""（空字符串）即可 - 启用鉴权后，Secret 必须与 Portal 中应用设置的密钥完全一致（区分大小写）
- IP 地址不能写
http://前缀，只填192.168.1.100:8080这类裸地址，否则连接超时
配置变更监听要配合 g.Cfg().Watch() 才真正生效
光写 @ApolloConfigChangeListener 注解没用——那是 Spring Boot 的写法。GoFrame 里监听靠的是 g.Cfg().Watch() 返回的 channel。
- 必须在
g.Cfg().SetAdapter(adapter)之后调用g.Cfg().Watch() - 监听到变更后，需手动触发业务逻辑刷新，比如重载数据库连接池参数
- 不要在
Watch()的 goroutine 里做耗时操作，否则阻塞后续事件；建议发到工作 channel 处理
最容易被忽略的点：Apollo 的「发布」动作是独立步骤。你在 Portal 修改完配置，必须点「发布」按钮，否则 Go 客户端永远拉不到新值——这个状态不会自动同步，也没有延迟补偿机制。
