Power Platform插件包抛出异常时能否获取源码行号？

问题概述 #

• 插件以NuGet包形式部署到Power Platform，基于.NET net462 SDK风格项目
• Debug模式构建，捕获异常时通过StackTrace无法获取源码行号和文件名，仅能得到方法调用链
• 已尝试嵌入符号、包含PDB等配置，但无效

核心原因 #

1. Power Platform运行环境的符号加载限制：平台不会自动加载外部PDB文件，且net462的嵌入式符号实现与后续.NET版本存在差异，平台运行时可能无法解析这类嵌入符号
2. net462的StackTrace行为限制：该框架版本下，即便存在嵌入式符号，StackTrace(ex, true)也可能无法正确提取文件路径和行号信息

可行解决方案 #

方案1：自定义异常携带行号信息（无需依赖符号文件） #

通过自定义异常类，结合编译器特性在抛出异常时自动注入行号和文件名：

// 自定义异常类
public class PluginBusinessException : Exception
{
    public int LineNumber { get; }
    public string FilePath { get; }

    public PluginBusinessException(string message, 
        [System.Runtime.CompilerServices.CallerLineNumber] int lineNumber = 0,
        [System.Runtime.CompilerServices.CallerFilePath] string filePath = "") 
        : base(message)
    {
        LineNumber = lineNumber;
        FilePath = filePath;
    }
}

// 业务逻辑中抛出异常
throw new PluginBusinessException("数据校验失败");

// 捕获异常时的追踪逻辑
try
{
    logic.ThrowException();
}
catch (PluginBusinessException ex)
{
    localPluginContext.Trace($@"
        异常信息: {ex.Message},
        行号: {ex.LineNumber},
        文件: {System.IO.Path.GetFileName(ex.FilePath)}");
}
catch (Exception ex)
{
    // 处理非自定义异常，尝试遍历栈帧寻找有效信息
    var stackTrace = new StackTrace(ex, true);
    foreach (var frame in stackTrace.GetFrames() ?? Array.Empty<StackFrame>())
    {
        var line = frame.GetFileLineNumber();
        var file = frame.GetFileName();
        if (line > 0 && !string.IsNullOrEmpty(file))
        {
            localPluginContext.Trace($"异常位置: {System.IO.Path.GetFileName(file)} 第{line}行");
            break;
        }
    }
    localPluginContext.Trace($"完整栈追踪: {ex.StackTrace}");
}

方案2：调整项目配置，使用符号服务器加载PDB #

针对net462项目，修改.csproj配置生成单独的符号包，再将符号包发布到符号服务器，配置Power Platform环境拉取符号：

<PropertyGroup>
    <DebugType>full</DebugType>
    <DebugSymbols>true</DebugSymbols>
    <IncludeSymbols>true</IncludeSymbols>
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
    <PublishRepositoryUrl>true</PublishRepositoryUrl>
    <EmbedUntrackedSources>true</EmbedUntrackedSources>
</PropertyGroup>

• 将生成的.snupkg符号包发布到Azure Artifacts等支持的符号服务器
• 在Power Platform管理中心配置符号服务器地址，确保运行时能拉取对应版本的PDB文件

方案3：用IL织入工具自动注入异常详情 #

借助Fody工具在编译阶段自动为所有异常添加行号、文件名信息，无需手动修改业务代码：

1. 安装Fody和ExceptionDetailsFody NuGet包
2. 在项目根目录创建FodyWeavers.xml文件：

<Weavers>
    <ExceptionDetails />
</Weavers>

3. 捕获异常时从Exception.Data中读取自动注入的信息：

catch (Exception ex)
{
    if (ex.Data.Contains("LineNumber") && ex.Data.Contains("FileName"))
    {
        localPluginContext.Trace($@"
            异常位置: {ex.Data["FileName"]} 第{ex.Data["LineNumber"]}行,
            异常信息: {ex.Message}");
    }
}

注意事项 #

• Power Platform对插件体积和性能有严格限制，嵌入符号或织入信息仅建议在测试/调试环境使用，生产环境可关闭相关逻辑
• 自定义异常方案无需依赖外部服务，稳定性更高，适合生产环境的基础调试需求

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