.NET Core 3.1 Linux环境下AWSSDK.SecurityToken无法加载求助

一、手动复制DLL无效的核心原因 #

.NET Core（含.NET 5+）依赖NuGet依赖管理系统处理程序集引用，手动复制DLL极易引发以下问题：

• 版本不兼容：AWSSDK的各个组件（S3、Core、SecurityToken）必须使用完全一致的版本，版本 mismatch 会直接导致加载失败。
• 依赖链不完整：AWSSDK.SecurityToken可能依赖其他未手动复制的程序集（如AWSSDK.Runtime、特定System.*类库），手动复制无法覆盖所有间接依赖。
• 运行时识别逻辑：.NET Core运行时优先从NuGenerate生成的deps.json文件读取依赖列表，手动放入的DLL若不在该列表中，运行时会忽略加载。

二、正确的依赖处理步骤 #

1. 通过NuGet安装依赖
   放弃手动复制DLL，直接用.NET CLI安装所需包，NuGet会自动处理所有依赖关系：

   dotnet add package AWSSDK.S3
   dotnet add package AWSSDK.SecurityToken
   

   安装后，项目会自动生成正确的deps.json和runtimeconfig.json文件，确保所有依赖被正确识别。

2. 清理缓存并重新构建
   执行以下命令清理旧缓存，确保依赖完全同步：

   dotnet clean
   dotnet restore
   dotnet build --configuration Release
   

3. 发布时打包所有依赖
   若需发布应用，使用--self-contained参数将.NET运行时、AWS SDK及所有依赖打包到发布目录：

   dotnet publish --configuration Release --self-contained true --runtime linux-x64
   

   发布后的目录会包含所有必要文件，无需手动补充DLL。

三、查看DLL搜索路径与加载版本的方法 #

1. 输出运行时加载日志 #

设置环境变量COREHOST_TRACE=1运行应用，可获取详细的依赖加载过程，包括搜索路径、尝试加载的版本：

COREHOST_TRACE=1 dotnet your-app.dll

日志中会出现类似Attempting to load assembly AWSSDK.SecurityToken, Version=3.3.0.0的条目，同时列出所有搜索的目录。

2. 分析程序集加载状态 #

使用dotnet-dump工具生成应用转储文件，分析已加载的程序集：

# 安装工具
dotnet tool install --global dotnet-dump
# 收集转储文件（替换为应用进程ID）
dotnet dump collect -p <your-app-pid>
# 分析转储文件
dotnet dump analyze <dump-file-path>
# 在分析器中执行命令查看加载的程序集
clrstack -a

3. 检查DLL版本信息 #

使用ildasm查看DLL的版本元数据（需先安装mono-devel）：

ildasm -metadata AWSSDK.SecurityToken.dll | grep Version

四、常见排查要点 #

• 确认所有AWSSDK包版本完全一致：查看项目.csproj文件中的PackageReference节点，确保版本号统一。
• 检查deps.json文件：在构建输出目录中搜索AWSSDK.SecurityToken，确认其路径和版本与本地DLL匹配。
• 验证目录权限：确保应用对DLL所在目录有读取权限，避免因权限不足导致加载失败。

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