1.4 常见问题

1. 框架主模块与子模块版本不一致的问题

原因：由于框架采用的是模块化设计，每个模块都有自己的版本号，而主模块的版本号是所有子模块版本号的基础。因此，在使用框架时，需要注意主模块与子模块的版本号是否一致，否则可能会导致一些不可预料的问题。

例如：due主模块版本为v2.3.2，而子模块lock/redis版本为v2.0.0-20250902100831-0402c3a6689f，这就会导致版本不一致的问题。

github.com/dobyte/due/v2 v2.3.2
github.com/dobyte/due/lock/redis/v2 v2.0.0-20250902100831-0402c3a6689f

解决：

1.进入到release (opens new window)页面，找到框架发布的版本号对应的commit号：93262b5。

2.执行go get github.com/dobyte/due/lock/redis/v2@93262b5拉取与主模块本版对应的子模块。

3.至此，问题解决。

2. 使用nacos v2.3.0及以后版本，node节点服路由数量较多时，可能导致实例注册失败的问题。

原因：nacos 2.3.0及以后版本引入了统一的参数校验逻辑，以确保请求参数的合法性并避免潜在的问题。具体到这个问题，元数据（Metadata）的长度超过了服务端允许的最大值1024个字符。详见 (opens new window)

解决：在${nacos.home}/conf目录下的application.properties文件中，设置nacos.core.param.check.enabled=false来关闭服务端的参数校验功能。