C#在Linux环境下使用Process启动外部程序传参异常问题咨询

问题成因 #

• 核心差异来自进程启动方式的不同：终端手动执行命令时，输入的内容会先经过shell解析处理，再传递给目标程序；而代码中设置了UseShellExecute = false，此时.NET运行时会直接将Arguments字符串按空白字符拆分，再传入系统调用execvp启动进程，全程不会做任何shell级别的转义、引号识别、特殊字符处理：
  • 若任意参数值（如channelName、GetToken(channelName)返回的token）包含空格、单双引号、shell元字符（$、&、*、?、|等），拼接后的Arguments字符串拆分得到的参数列表，就会和shell解析后的结果不一致，导致目标程序收到错误参数
  • 部分场景下打印的Arguments看起来和手动输入的内容完全一致，但可能包含打印不可见的控制字符，或者引号没有正确转义，最终导致参数拆分错误
• 另一常见诱因是工作目录不一致：代码启动进程时未显式指定WorkingDirectory，如果外部程序依赖相对路径读取资源，就可能抛出类似参数错误的提示；而手动执行时的工作目录恰好符合要求，因此可以正常运行

解决方案 #

方案1：使用ArgumentList传递参数（推荐，适用于.NET Core 3.0+ / .NET 5+ 及以上版本） #

不要手动拼接Arguments字符串，直接使用ProcessStartInfo内置的ArgumentList集合逐个添加参数，.NET运行时会自动处理所有转义逻辑，保证每个参数都完整传递给目标程序，无需自行处理特殊字符：

private static void StartRecording(string channelName)
{
    Console.WriteLine($"Starting recording of the channel {channelName}");
    if (RecordingProcesses.ContainsKey(channelName)) return;
    Process recordingProcess = new Process
    {
        StartInfo = new ProcessStartInfo
        {
            UseShellExecute = false, 
            FileName = RecorderPath,
            // 逐个添加参数，无需手动转义
            ArgumentList = 
            {
                "--appId", AppId,
                "--channel", channelName,
                "--uid", RecordingUid.ToString(),
                "--channelProfile", "0",
                "--appliteDir", AppliteDir,
                "--channelKey", GetToken(channelName)
            },
            // 可选：显式指定工作目录和手动执行时的目录一致
            WorkingDirectory = "/path/to/your/workdir"
        }
    };
    recordingProcess.Exited += delegate { OnProcessExited(channelName); };
    recordingProcess.Start();
    RecordingProcesses.Add(channelName, recordingProcess);
}

方案2：兼容旧版本.NET的处理方式 #

如果使用的.NET版本不支持ArgumentList，可以选择以下两种方式之一处理：

1. 手动转义所有参数值：给每个可能包含特殊字符的参数值用单引号包裹，同时对值内部的单引号做转义处理

// 参数转义工具方法
private static string EscapeShellArgument(string arg)
{
    return $"'{arg.Replace("'", "'\\''")}'";
}

// 启动进程代码修改如下
Process recordingProcess = new Process
{
    StartInfo = new ProcessStartInfo
    {
        UseShellExecute = false, 
        FileName = RecorderPath,
        Arguments = $"--appId {EscapeShellArgument(AppId)} --channel {EscapeShellArgument(channelName)} --uid {EscapeShellArgument(RecordingUid.ToString())} --channelProfile 0 " +
                    $"--appliteDir {EscapeShellArgument(AppliteDir)} --channelKey {EscapeShellArgument(GetToken(channelName))}",
        WorkingDirectory = "/path/to/your/workdir"
    }
};

2. 开启shell执行：将UseShellExecute设置为true，让系统shell负责参数解析，效果和终端手动执行完全一致

注意：开启shell执行会有极低的性能损耗，同时如果参数值来自不可信输入，存在shell注入风险，需提前做好参数校验

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