.NET 6控制台程序加载SQL Server Spatial库失败排查求助

针对你遇到的.NET 6控制台应用在生产环境加载SqlServerSpatial160.dll失败的问题，可按以下步骤逐一排查：

1. 检查DLL依赖项（错误码126核心排查点） #

错误码126大多不是主DLL找不到，而是主DLL依赖的系统组件缺失：

• 打开VS开发者命令提示符，执行：dumpbin /dependents 你的应用路径\runtimes\win-x64\native\SqlServerSpatial160.dll，查看依赖的系统DLL（比如VC++运行时库）。
• 对比生产环境与正常环境的这些依赖DLL版本，确认生产环境是否安装了对应版本的VC++ Redistributable（SQL Server 2022相关的空间库通常依赖VC++ 2019或更高版本）。
• 也可直接用Dependency Walker工具扫描生产环境的SqlServerSpatial160.dll，标记为红色的项就是缺失的依赖。

2. 强制指定DLL加载路径 #

绕过.NET自动路径探测逻辑，手动指定加载路径：
在程序启动初期（调用SqlGeometry相关方法前）添加以下代码：

using System;
using System.IO;
using System.Reflection;
using System.Runtime.InteropServices;

var nativeDllDir = Path.Combine(AppContext.BaseDirectory, "runtimes", "win-x64", "native");
NativeLibrary.SetDllImportResolver(Assembly.Load("Microsoft.SqlServer.Types"), (dllName, _, _) =>
{
    if (dllName.Equals("SqlServerSpatial160", StringComparison.OrdinalIgnoreCase))
    {
        var fullPath = Path.Combine(nativeDllDir, "SqlServerSpatial160.dll");
        return NativeLibrary.Load(fullPath);
    }
    return IntPtr.Zero;
});

3. 验证DLL完整性与权限 #

• 用PowerShell对比文件哈希：在正常环境执行Get-FileHash SqlServerSpatial160.dll，生产环境执行相同命令，确认哈希值一致，排除DLL被篡改或损坏的可能。
• 手动替换生产环境的SqlServerSpatial160.dll为正常环境的副本，测试是否能正常运行。
• 检查runtimes\win-x64\native目录的NTFS权限，确保应用运行账户（即使是管理员，也要确认）有读取权限。

4. 检查进程加载状态与系统安全设置 #

• 用Process Explorer打开应用进程，查看「模块」列表，确认SqlServerSpatial160.dll是否真的被加载。如果未加载，说明读取成功但加载失败，需排查系统安全策略：
  • 检查生产环境是否开启了严格的DEP（数据执行保护）或ASLR模式，可临时关闭DEP测试（仅用于排查，生产环境需谨慎操作）。
  • 确认安全软件是否静默拦截了DLL加载（即使日志无记录，可临时禁用安全软件测试）。

5. 核对发布配置与运行时环境 #

• 确认生产环境与正常环境的发布配置一致：比如都是win-x64架构、Release模式，未启用单文件发布（单文件发布可能导致原生DLL路径异常）。
• 检查应用目录下的.runtimeconfig.json，确认运行时依赖版本正确，无冲突配置。

6. 启用加载日志获取详细信息 #

创建环境变量COMPLUS_LoadLogPath，值设为日志文件路径（如C:\temp\load_log.txt），运行应用触发错误后，日志会记录每一步DLL加载的尝试与失败原因，精准定位具体问题。

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