Golang(Gopls)类型正确仍报incompatibleAssign错误如何解决

Go开发过程中，将time.Duration类型的timeout变量传入context.WithTimeout方法时，代码逻辑符合预期，但触发incompatibleAssign类型不匹配报错。

报错信息 #

var timeout time.Duration
cannot use timeout (variable of type time.Duration) as time.Duration 
value in argument to context.WithTimeout

复现代码 #

timeout := time.Duration(30 * time.Second)
ctx, cancelFn := context.WithTimeout(context.Background(), timeout)
defer cancelFn()

注：以上代码本身语法完全符合Go规范，正常配置的Go环境中可直接运行无报错。

报错原因 #

报错里两个看起来完全一致的time.Duration实际不是同一个类型。Go是强类型语言，哪怕两个类型的底层结构完全相同，只要定义的包路径不同，就会被判定为不同类型，不允许直接传参。
常见触发场景：

• 导入的context包不是标准库版本：比如旧项目误用了golang.org/x/net/context，且该依赖版本过旧，和当前标准库的类型校验不兼容
• Go模块缓存损坏，或者IDE的gopls语言服务缓存异常，把同一个标准库类型错误识别成了两个不同来源的类型
• 导入块存在错误：比如导入了自定义的同名time包，或者给time包起别名后混用，导致类型识别偏差

解决步骤 #

1. 先检查代码的import配置，确认context和time都来自标准库，导入路径分别为"context"和"time"，没有同名包冲突、错误别名的问题
2. 清理本地模块缓存后重新拉取依赖，执行以下命令：

go clean -modcache
go mod tidy

3. 重启编辑器，重置gopls语言服务的缓存，绝大多数缓存导致的类型识别错误在这一步就会解决
4. 如果是第三方依赖版本过旧间接导致的类型冲突，执行go get -u升级所有依赖到兼容当前Go版本的版本即可

内容的提问来源于stack exchange，提问作者Aamir Maniar