在GitHub Actions中运行带参数的CoreServer.exe遇空引用异常

本地运行带-c和-s参数的CoreServer.exe正常，但GitHub Actions中执行报System.NullReferenceException，核心原因大概率是CI环境中参数未正确传递，导致代码里读取参数的逻辑拿到了null值，进而引发未初始化对象的访问错误。

1. 先确认CI执行上下文与参数传递是否正确 #

在GitHub Actions Workflow中添加调试步骤，明确当前工作目录、程序路径和执行命令，避免路径或参数遗漏：

- name: Debug execution context
  run: |
    echo "Current working directory: $(pwd)"
    echo "CoreServer path: ./bin/Release/net6.0/CoreServer.exe" # 替换为你的实际编译输出路径
    ls -la ./bin/Release/net6.0/ # 验证程序是否存在

然后修改执行命令，确保参数传递格式正确：

- name: Run CoreServer
  run: ./bin/Release/net6.0/CoreServer.exe -c [你的配置参数值] -s [你的服务参数值]

注意：CI环境的工作目录可能和本地不同，务必使用绝对路径或相对当前工作目录的完整路径调用程序。

2. 检查C#代码的参数解析逻辑 #

如果是直接通过args数组读取参数，必须先判断参数数量是否达标，避免索引越界或null值传递：

// 错误示例：未判断参数长度就直接访问
// string cParam = args[0];  // 若CI中参数未传，args长度为0，后续处理可能引发NullReferenceException

// 正确处理方式
if (args.Length < 4) // -c、值、-s、值 共4个元素
{
    Console.WriteLine("Missing required arguments: -c <config> and -s <server>");
    Environment.Exit(1);
}

// 更可靠的方式：使用命令行解析库（如CommandLineParser）
var result = CommandLine.Parser.Default.ParseArguments<CliOptions>(args);
result.WithParsed(options =>
{
    // 直接使用options.C和options.S，库会自动处理参数缺失/格式错误
}).WithNotParsed(errors =>
{
    Console.WriteLine("Invalid command line arguments");
    Environment.Exit(1);
});

// 定义参数模型
public class CliOptions
{
    [Option('c', Required = true)]
    public string C { get; set; }

    [Option('s', Required = true)]
    public string S { get; set; }
}

如果用管道输入（如echo "c" | CoreServer.exe -s xxx），要确保代码中Console.ReadLine()的逻辑和命令行参数逻辑不冲突，且CI中管道输入确实传递了有效值。

3. 捕获异常并打印详细调用栈 #

在代码入口添加全局异常捕获，明确报错的具体位置，方便定位问题：

try
{
    // 程序核心逻辑
}
catch (NullReferenceException ex)
{
    Console.WriteLine($"NullReferenceException Details:");
    Console.WriteLine($"Message: {ex.Message}");
    Console.WriteLine($"Stack Trace:\n{ex.StackTrace}");
    Environment.Exit(1);
}

查看CI日志中的异常调用栈，就能直接定位到哪个对象为null，反推是参数未传递还是参数解析逻辑错误。

4. 确保CI环境的.NET版本与本地一致 #

如果CoreServer.exe是.NET Core/.NET 5+程序，需在Workflow中指定和本地一致的SDK版本：

- name: Setup .NET
  uses: actions/setup-dotnet@v4
  with:
    dotnet-version: '6.0.x' # 替换为你本地使用的.NET版本

版本不匹配可能导致程序运行时出现意外的null引用或兼容性问题。

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