SQL Server 2016加载CLR报缺少types v14程序集解决方法

向SQL Server 2016加载自定义CLR程序集时抛出如下错误：

程序集“xxx”引用了当前数据库中不存在的程序集“microsoft.sqlserver.types, version=14.0.0.0, culture=neutral, publickeytoken=89845dcd8080cc91”。

• 当前SQL Server环境内置microsoft.sqlserver.types v13版本系统程序集，不支持删除、修改操作
• 受上述系统程序集的版本锁定限制，此前尝试直接在库内部署microsoft.sqlserver.types v14版本失败
• 全量检查Visual Studio项目的显式引用配置，未找到任何指向microsoft.sqlserver.types v14的引用记录
• 已尝试通过NuGet对相关依赖包执行安装、重装操作，问题未解决
• 业务侧不允许直接将依赖降级到microsoft.sqlserver.types v13：降级后报表模块依赖将失效，报表功能为核心必需业务

排查点1：传递依赖带来的隐式v14版本引用 #

项目中没有直接引用v14版本，不代表最终编译出的程序集没有绑定v14引用。绝大多数此类问题都是间接依赖导致：你引用的第三方组件、内部公共类库、报表SDK本身在编译时静态绑定了v14版本的Types程序集，这类引用不会出现在项目的直接引用列表里，只会写入最终生成dll的程序集清单中。

• 排查方法：打开Visual Studio开发人员命令提示符，进入CLR项目编译输出目录，执行命令 ildasm 你的CLR程序集名.dll /metadata:assemblyref，直接读取程序集的引用清单，顺着引用链定位到底是哪个依赖引入了v14版本的Types。
• 解决方法：不需要在SQL Server中部署v14版本程序集，在CLR项目中手动添加对实例内置v13版本Microsoft.SqlServer.Types.dll的引用（路径在SQL Server安装目录下的MSSQL\Binn文件夹中），将该引用的「特定版本」属性设为False、「复制本地」属性设为False，编译时会自动将所有指向v14的引用统一绑定到v13版本。v13和v14版本的Types公开接口兼容性极高，核心的空间类型、报表数据类型定义没有破坏性变更，不会影响业务逻辑运行。

排查点2：编译目录残留旧版本dll导致的错误绑定 #

执行NuGet重装后如果没有清理编译缓存，bin、obj目录下可能残留之前下载的v14版本Microsoft.SqlServer.Types.dll，编译器会优先加载本地输出目录下的dll，忽略你新配置的版本引用规则，导致最终输出的程序集仍然绑定v14版本。

• 排查方法：清空解决方案下所有项目的bin、obj文件夹，全局搜索整个解决方案目录内所有名为Microsoft.SqlServer.Types.dll的文件，右键查看文件详情中的版本号，确认是否有v14版本的残留文件。
• 解决方法：删除所有残留的v14版本dll，重新执行NuGet还原和全量编译，编译完成后再次用ildasm确认程序集引用清单中没有v14版本的Types引用，再尝试部署到SQL Server。

排查点3：报表依赖的版本绑定误区 #

认为必须依赖v14版本Types才能运行报表功能是常见误区。报表SDK对Types的依赖是基于程序集元数据匹配，而非强依赖v14的独有API。

• 解决方法：在报表服务的配置文件（web.config、ReportingServices.config）中添加程序集绑定重定向规则，将所有指向14.0.0.0版本Microsoft.SqlServer.Types的请求统一重定向到实例内置的13.0.0.0版本，该配置为官方支持的适配方案，不会影响报表功能的正常运行，不需要硬依赖v14版本的dll。

高风险备选方案（非必要不使用） #

如果你的业务确实用到了v14版本Types独有的API，无法通过版本绑定兼容，不要尝试修改或替换系统内置的v13版本程序集，会导致SQL Server实例系统功能异常。可以将CLR程序集权限集设置为UNSAFE，将v14版本的Microsoft.SqlServer.Types.dll作为用户自定义程序集单独部署，部署前必须在测试环境验证全量功能，确认不会和系统内置的v13版本产生类型冲突。

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