部署至Azure VM的控制台应用报错：找不到Metadata文件Newtonsoft.Json.dll

我之前部署类似的C#脚本处理应用到Windows Server时也碰到过这个坑，给你几个针对性的排查和解决方向：

1. 确保编译器使用程序集的绝对路径 #

CSharp编译器（不管是旧的CSharpCodeProvider还是Roslyn的编译服务）默认的程序集搜索路径可能不包含你的应用输出目录，尤其是当应用的工作目录和输出目录不一致时。

解决办法是手动把Newtonsoft.Json.dll的绝对路径添加到编译器引用里：

// 获取应用的基目录（也就是你的Debug文件夹路径）
var appBaseDir = AppDomain.CurrentDomain.BaseDirectory;
// 拼接出dll的完整路径
var jsonDllPath = Path.Combine(appBaseDir, "Newtonsoft.Json.dll");

// 创建编译器参数并添加引用
var compilerParams = new CompilerParameters();
compilerParams.ReferencedAssemblies.Add(jsonDllPath);

同时可以设置编译器的工作目录为应用基目录，进一步确保路径正确：

compilerParams.WorkingDirectory = appBaseDir;

2. 检查文件权限和锁定状态 #

Windows Server 2012R2的安全机制比较严格，很可能是运行应用的账户没有读取dll的权限：

• 右键Newtonsoft.Json.dll，打开「属性」→「安全」标签，确认运行应用的账户（比如Local System、你登录的账户或者自定义服务账户）拥有「读取和执行」权限。
• 如果dll是从压缩包或者网络复制过来的，可能带有Windows的锁定标记：在属性窗口底部看看有没有「解除锁定」按钮，点击它解锁文件。

3. 排查程序集版本冲突 #

有时候服务器的全局程序集缓存（GAC）里可能存在旧版本的Newtonsoft.Json，导致编译器优先加载GAC里的版本而不是你部署的本地dll：

• 对比本地和服务器上的Newtonsoft.Json.dll版本：右键dll→「属性」→「详细信息」查看文件版本，确保两者一致。
• 在Visual Studio里，把Newtonsoft.Json的引用属性设置为「复制本地 = True」，强制部署时带上正确版本的dll。
• 也可以在编译器引用里指定具体版本，避免加载GAC里的旧版本：

compilerParams.ReferencedAssemblies.Add("Newtonsoft.Json.dll, Version=13.0.3.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed");

（把版本号换成你实际使用的版本）

4. 确认Roslyn编译器的依赖完整 #

如果你的应用用的是Roslyn编译服务（而不是旧的CodeDom），服务器上可能缺少Roslyn的相关依赖：

• 检查应用的输出目录里是否包含Microsoft.CodeDom.Providers.DotNetCompilerPlatform.dll，以及Microsoft.Net.Compilers文件夹（里面有csc.exe等编译工具）。
• 如果没有这些文件，在Visual Studio里重新安装Microsoft.CodeDom.Providers.DotNetCompilerPlatform NuGet包，然后重新部署应用。

额外排查步骤 #

可以在应用里添加一段调试代码，打印当前的工作目录和程序集搜索路径，确认编译器能访问到你的dll目录：

Console.WriteLine("当前工作目录：" + Directory.GetCurrentDirectory());
Console.WriteLine("应用基目录：" + AppDomain.CurrentDomain.BaseDirectory);
if (!string.IsNullOrEmpty(AppDomain.CurrentDomain.RelativeSearchPath))
{
    foreach (var path in AppDomain.CurrentDomain.RelativeSearchPath.Split(';'))
    {
        Console.WriteLine("程序集搜索路径：" + path);
    }
}

运行后看看输出的路径里有没有你的Debug文件夹，这能帮你快速定位路径问题。

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