dotnet 简单写一个 pdb 符号文件下载器
dotnet 简单写一个 pdb 符号文件下载器
本文将告诉大家如何读取 PE 文件头信息，拼接 PDB 符号文件下载地址，从微软公共符号服务器拉取符号文件
本文将以拉取 ntdll.dll 为例子告诉大家如何从 msdl.microsoft.com 下载符号
我先将自己电脑上的 ntdll.dll 拷贝到输出路径，方便我进行访问。读取 C 盘的 Windows 文件夹的 DLL 文件也是有读取权限的，即不拷贝到输出路径也不会有任何的问题的
整体步骤是先读取 dll 的 PE 文件信息，获取到调试信息，即 PDB 名加 Guid 和 Age 参数，由以上三个参数拼接为下载地址
本文使用的 PEReader 等辅助类为 .NET Core 1.0 引入，如需在 .NET Framework 使用，请安装 System.Reflection.Metadata 库
本文建立的是 dotnet 9 的控制台文件
先使用 File.OpenRead 打开要读取的 DLL 文件，代码如下
var file = @"ntdll.dll";
using var fileStream = File.OpenRead(file);接着放入到 PEReader 里面读取，如此即可非常方便完成对 PE 文件的读取，代码如下
var peReader = new PEReader(fileStream);尝试读取传入的 PE 文件的调试目录信息，代码如下
var debugDirectoryEntries = peReader.ReadDebugDirectory();这里的调试目录可能有很多，咱只需使用 DebugDirectoryEntryType.CodeView 类型的即可
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
...
}在 DebugDirectoryEntry 里面存放的只是一些地址偏移和大小的信息，需要进一步调用 ReadCodeViewDebugDirectoryData 方法读取到更多信息，代码如下
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
var readCodeViewDebugDirectoryData = peReader.ReadCodeViewDebugDirectoryData(debugDirectoryEntry);
var path = readCodeViewDebugDirectoryData.Path;
var guid = readCodeViewDebugDirectoryData.Guid;
var age = readCodeViewDebugDirectoryData.Age;
var pdbName = path;
...
}如此即可获取到下载地址拼接的信息
var downloadUrl = $"http://msdl.microsoft.com/download/symbols/{pdbName}/{(guid.ToString("N").ToUpperInvariant() + age.ToString())}/{pdbName}";继续使用 HttpClient 将其下载下来，代码如下
var httpClient = new HttpClient();
using var httpResponseMessage = await httpClient.GetAsync(downloadUrl, HttpCompletionOption.ResponseHeadersRead);
var pdbFile = Path.GetFullPath(pdbName);
await using var downloadFileStream = File.Create(pdbFile);
await httpResponseMessage.Content.CopyToAsync(downloadFileStream);下载文件的方法十分简单，先是准备要下载的文件存放的路径，我这里使用的是相对工作路径的方式，即 var pdbFile = Path.GetFullPath(pdbName); 简单的方式拿到绝对路径。这里获取绝对路径仅仅只是为了方便调试而已，无实际逻辑意义
接着使用 File.Create 方法创建文件，且返回 FileStream 对象，方便进行下载内容的 CopyToAsync 写入到文件
以上代码的另一个细节是请求的时候带上了 HttpCompletionOption.ResponseHeadersRead 参数，带上这个参数将告诉 HttpClient 不要等待内容都拉取完了再让 GetAsync 方法返回，而是只要 http 的头信息拿到了，就应该返回了。这一点对下载文件来说，比较有优化，大部分下载的文件的文件长度都不小，全等待下载完成再让 GetAsync 返回，再拷贝到文件，这个逻辑相对来说是比较亏的。只有对 API 调用形的后台访问，才合适使用默认的 HttpCompletionOption.ResponseContentRead 参数，全部完成再返回，如此可以更简化异常处理情况，确保网络通讯完成再返回
通过上文简单的方式即可完成对 DLL 的符号文件下载
以上代码其实还隐藏了另一个功能，那就是自己组建符号服务器，可以自己在构建完成之后，根据如上信息，将 PDB 符号文件存放到合适的路径里面或记录到数据库里面，不依赖 symstore 工具
本文的 Program.cs 代码如下
using System.Reflection.PortableExecutable;
using System.Runtime.InteropServices;
using System.Text;
var file = @"ntdll.dll";
using var fileStream = File.OpenRead(file);
var peReader = new PEReader(fileStream);
var httpClient = new HttpClient();
var debugDirectoryEntries = peReader.ReadDebugDirectory();
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
var readCodeViewDebugDirectoryData = peReader.ReadCodeViewDebugDirectoryData(debugDirectoryEntry);
var path = readCodeViewDebugDirectoryData.Path;
var guid = readCodeViewDebugDirectoryData.Guid;
var age = readCodeViewDebugDirectoryData.Age;
var pdbName = path;
var downloadUrl = $"http://msdl.microsoft.com/download/symbols/{pdbName}/{(guid.ToString("N").ToUpperInvariant() + age.ToString())}/{pdbName}";
using var httpResponseMessage = await httpClient.GetAsync(downloadUrl, HttpCompletionOption.ResponseHeadersRead);
var pdbFile = Path.GetFullPath(pdbName);
await using var downloadFileStream = File.Create(pdbFile);
await httpResponseMessage.Content.CopyToAsync(downloadFileStream);
}本文代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快
先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码
git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 6bc0a171f53f4da8a968257c621c9df7a6de77a3以上使用的是国内的 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码，将 gitee 源换成 github 源进行拉取代码。如果依然拉取不到代码，可以发邮件向我要代码
git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 6bc0a171f53f4da8a968257c621c9df7a6de77a3获取代码之后，进入 Workbench/WerjiwaijogoNemcuryecho 文件夹，即可获取到源代码
腾讯云开发者
