c# - 如何诊断 dnx 中缺少的依赖项(或其他加载程序故障)？

Question

我正在尝试运行 HelloWeb sample 的修改版本用于使用 Kestrel 的 DNX 上的 ASP.NET vNext。我知道这在很大程度上处于最前沿，但我希望 ASP.NET 团队至少能保持最简单的 Web 应用程序正常工作:)

环境:

Linux(Ubuntu，差不多)

单声道 3.12.1

DNX 1.0.0-beta4-11257(我也有 11249 可用)

“Web 应用程序”代码，在 Startup.cs 中:

using Microsoft.AspNet.Builder;
public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseWelcomePage();
    }
}

项目配置，在 project.json :

{
  "dependencies": {
    "Kestrel": "1.0.0-beta4",
    "Microsoft.AspNet.Diagnostics": "1.0.0-beta4",
    "Microsoft.AspNet.Hosting": "1.0.0-beta4",
    "Microsoft.AspNet.Server.WebListener": "1.0.0-beta4",
    "Microsoft.AspNet.StaticFiles": "1.0.0-beta4",
    "Microsoft.Framework.Runtime": "1.0.0-beta4",
    "Microsoft.Framework.Runtime.Common": "1.0.0-beta4",
    "Microsoft.Framework.Runtime.Loader": "1.0.0-beta4",
    "Microsoft.Framework.Runtime.Interfaces": "1.0.0-beta4",
  },
  "commands": {
    "kestrel": "Microsoft.AspNet.Hosting --server Kestrel --server.urls http://localhost:5004"
  },
  "frameworks": {
    "dnx451": {}
  }
}

kpm restore似乎工作正常。

然而，当我尝试运行时，我收到一个异常提示 Microsoft.Framework.Runtime.IApplicationEnvironment找不到。命令行和错误(有点重新格式化)

.../HelloWeb$ dnx . kestrel
System.IO.FileNotFoundException: Could not load file or assembly 
'Microsoft.Framework.Runtime.IApplicationEnvironment,
  Version=0.0.0.0, Culture=neutral, PublicKeyToken=null'
or one of its dependencies.
File name: 'Microsoft.Framework.Runtime.IApplicationEnvironment,
  Version=0.0.0.0, Culture=neutral, PublicKeyToken=null'
  at (wrapper managed-to-native) System.Reflection.MonoMethod:InternalInvoke 
    (System.Reflection.MonoMethod,object,object[],System.Exception&)
  at System.Reflection.MonoMethod.Invoke 
    (System.Object obj, BindingFlags invokeAttr, System.Reflection.Binder binder,
     System.Object[] parameters, System.Globalization.CultureInfo culture)
    [0x00000] in <filename unknown>:0

虽然显然，我最迫切的需要是解决这个问题，但我也很感激有关如何诊断问题的建议，以便我将来可以自己解决类似的问题。 (这也可能使这个问题对其他人更有用。)

我找到了 Microsoft.Framework.Runtime.IApplicationEnvironment在 Microsoft.Framework.Runtime.Interfaces assembly source ，而且最近似乎没有改变。不清楚为什么异常显示名称好像它本身就是一个完整的程序集，而不仅仅是另一个程序集中的接口(interface)。我猜这可能是由于 assembly neutral interfaces ，但从错误中并不清楚。 ( [AssemblyNeutral] is dead, so that's not it... )

Answer 1

好问题。对于您的特定问题，您解决的依赖项似乎不匹配。当发生这样的事情时，很可能是因为您在不兼容的 dnx 上运行您的应用程序。我们仍在进行非常大的突破性更改，因此如果您看到缺少类型的方法，您很可能最终会运行 betaX包和 betaY dnx，反之亦然。

更具体地说，Assembly Neutral Interfaces已在 beta4 中删除，但看起来您正在运行的应用程序仍在使用它们。

我们计划这样做，以便程序包可以标记它们运行所需的最小 dnx，以使错误消息更加清晰。此外，随着时间的推移，重大变化将逐渐消失。

但总的来说，我觉得是时候写一篇关于如何在使用 dnx 时诊断此类问题的指南了(因为它与现有的 .NET 非常不同)。

您放入的依赖项 project.json只是顶级。版本也是总是最小值 (它就像一个 NuGet 包)。这意味着当您指定 Foo 1.0.0-beta4 时你真的在指定 Foo >= 1.0.0-beta4 .这意味着如果您要求 MVC 0.0.1并且您配置的提要的最低版本是 MVC 3.0.0 ，你会得到那个。我们也永远不会 float 您的版本，除非您指定它。如果您要求 1.0.0 并且它存在，即使存在较新的版本，您也会得到 1.0.0。指定空版本总是不好的，在以后的版本中将被禁止。

我们向 nuget 引入了一项新功能，称为 float 版本。今天它只适用于预发布标签，但在下一个版本中它将适用于版本的更多部分。这类似于 npm 和 gem 语法，用于在包规范文件中指定版本范围。
1.0.0-* - 意味着给我匹配前缀的最高版本(根据 semantic versioning rules )或者如果没有匹配该前缀的版本，使用正常行为并获取最低版本>=指定版本。

当您在最新版本中运行 restore 时，它​​会写出一个名为 project.lock.json 的文件。 .该文件将具有 project.json 中定义的所有目标框架的依赖关系的传递闭包。 .

当这样的事情失败时，您可以执行以下操作:

使用 kpm list 查看解析的依赖项.这将向您显示项目引用的包的已解析版本以及将其引入的依赖项。例如如果 A -> B，它会显示:

A  -> BB ->

Actual KPM list output:

Listing dependencies for ClassLibrary39 (C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json)

[Target framework DNX,Version=v4.5.1 (dnx451)]

 framework/Microsoft.CSharp 4.0.0.0
    -> ClassLibrary39 1.0.0
 framework/mscorlib 4.0.0.0
    -> ClassLibrary39 1.0.0
 framework/System 4.0.0.0
    -> ClassLibrary39 1.0.0
 framework/System.Core 4.0.0.0
    -> ClassLibrary39 1.0.0
*Newtonsoft.Json 6.0.1
    -> ClassLibrary39 1.0.0

[Target framework DNXCore,Version=v5.0 (dnxcore50)]

*Newtonsoft.Json 6.0.1
    -> ClassLibrary39 1.0.0
 System.Runtime 4.0.20-beta-22709
    -> ClassLibrary39 1.0.0

* 表示直接依赖。

如果您有一个正在运行的 Visual Studio(它现在与 DNX 中断了)，您可以查看引用节点。它具有相同的可视化数据:



让我们看看依赖失败是什么样的:

这是project.json

{
    "version": "1.0.0-*",
    "dependencies": {
        "Newtonsoft.Json": "8.0.0"
    },

    "frameworks" : {
        "dnx451" : { 
            "dependencies": {
            }
        },
        "dnxcore50" : { 
            "dependencies": {
                "System.Runtime": "4.0.20-beta-22709"
            }
        }
    }
}

Newtonsoft.Json 8.0.0不存在。所以运行 kpm restore 显示以下内容:



当诊断恢复可能失败时，查看发出的 HTTP 请求，它们会告诉您 kpm 查看了哪些配置的包源。请注意，在上图中，有一个 CACHE要求。这是基于资源类型(nupkg 或 nuspec)的内置缓存，并具有可配置的 TTL(查看 kpm restore --help)。如果要强制 kpm要访问远程 NuGet 源，请使用 --no-cache标志:



这些错误也显示在 Visual Studio 的包管理器日志输出窗口中:



旁注!

包源

我将描述 NuGet.config 现在的工作方式(将来可能会改变)。默认情况下，您有一个 NuGet.config，在 %appdata%\NuGet\NuGet.Config 中全局配置了默认的 NuGet.org 源。 .您可以在 Visual Studio 中或使用 NuGet 命令行工具管理这些全局源。在尝试诊断故障时，您应该始终查看有效来源(kpm 输出中列出的来源)。

阅读有关 NuGet.config 的更多信息 here

回到现实:

当依赖项未解决时，运行该应用程序将为您提供以下信息:

> dnx . run
System.InvalidOperationException: Failed to resolve the following dependencies for target framework 'DNX,Version=v4.5.1':
   Newtonsoft.Json 8.0.0

Searched Locations:
  C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\{name}\project.json
  C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\test\{name}\project.json
  C:\Users\davifowl\.dnx\packages\{name}\{version}\{name}.nuspec
  C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\{name}.dll
  C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\Facades\{name}.dll
  C:\WINDOWS\Microsoft.NET\assembly\GAC_32\{name}\{version}\{name}.dll
  C:\WINDOWS\Microsoft.NET\assembly\GAC_64\{name}\{version}\{name}.dll
  C:\WINDOWS\Microsoft.NET\assembly\GAC_MSIL\{name}\{version}\{name}.dll

Try running 'kpm restore'.

   at Microsoft.Framework.Runtime.DefaultHost.GetEntryPoint(String applicationName)
   at Microsoft.Framework.ApplicationHost.Program.ExecuteMain(DefaultHost host, String applicationName, String[] args)
   at Microsoft.Framework.ApplicationHost.Program.Main(String[] args)

运行时基本上会尝试在尝试运行之前验证整个依赖关系图是否已解决。如果它建议运行 kpm restore这是因为它找不到列出的依赖项。

您可能会收到此错误的另一个原因是，如果您运行了错误的 dnx 风格。如果您的应用程序仅指定 dnx451 并且您尝试运行 CoreCLR dnx，您可能会看到类似的问题。密切关注错误信息中的目标框架:

对于运行:

dnx4x - runs on dnx-clr-{etc}
dnxcore50 - runs on dnx-coreclr-{etc}

当您尝试运行时，您应该记住在 project.json 中定义的从 clr 到目标框架的心理映射。 .

这也显示在 Visual Studio 中的引用节点下:


标记为黄色的节点未解析。

这些也显示在错误列表中:



build

构建时也会出现这些错误。从命令行构建时，输出非常冗长，在诊断问题时非常有用:

> kpm build

Building ClassLibrary39 for DNX,Version=v4.5.1
  Using Project dependency ClassLibrary39 1.0.0
    Source: C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json

  Using Assembly dependency framework/mscorlib 4.0.0.0
    Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\mscorlib.dll

  Using Assembly dependency framework/System 4.0.0.0
    Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\System.dll

  Using Assembly dependency framework/System.Core 4.0.0.0
    Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\System.Core.dll

  Using Assembly dependency framework/Microsoft.CSharp 4.0.0.0
    Source: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5.1\Microsoft.CSharp.dll


Building ClassLibrary39 for DNXCore,Version=v5.0
  Using Project dependency ClassLibrary39 1.0.0
    Source: C:\Users\davifowl\Documents\Visual Studio 14\Projects\ClassLibrary39\src\ClassLibrary39\project.json

  Using Package dependency System.Console 4.0.0-beta-22709
    Source: C:\Users\davifowl\.dnx\packages\System.Console\4.0.0-beta-22709
    File: lib\contract\System.Console.dll

  Using Package dependency System.IO 4.0.10-beta-22231
    Source: C:\Users\davifowl\.dnx\packages\System.IO\4.0.10-beta-22231
    File: lib\contract\System.IO.dll

  Using Package dependency System.Runtime 4.0.20-beta-22231
    Source: C:\Users\davifowl\.dnx\packages\System.Runtime\4.0.20-beta-22231
    File: lib\contract\System.Runtime.dll

  Using Package dependency System.Text.Encoding 4.0.10-beta-22231
    Source: C:\Users\davifowl\.dnx\packages\System.Text.Encoding\4.0.10-beta-22231
    File: lib\contract\System.Text.Encoding.dll

  Using Package dependency System.Threading.Tasks 4.0.10-beta-22231
    Source: C:\Users\davifowl\.dnx\packages\System.Threading.Tasks\4.0.10-beta-22231
    File: lib\contract\System.Threading.Tasks.dll

输出显示从包和项目引用传递到编译器的所有程序集。当您开始遇到构建失败时，查看此处以确保您使用的包实际在该目标平台上工作是很有用的。

这是一个不适用于 dnxcore50 的软件包示例:

{
    "version": "1.0.0-*",
    "dependencies": {
        "Microsoft.Owin.Host.SystemWeb": "3.0.0"
    },

    "frameworks": {
        "dnx451": {
            "dependencies": {
            }
        },
        "dnxcore50": {
            "dependencies": {
                "System.Console": "4.0.0-beta-22709"
            }
        }
    }
}

Microsoft.Owin.Host.SystemWeb 3.0.0 版没有任何在 dnxcore50 上运行的程序集(查看解压包的 lib 文件夹)。当我们运行时 kpm build :



请注意，它说“使用包 Microsoft.Owin.Host.SystemWeb”，但没有“文件:”。这可能是构建失败的原因。

到此结束我的脑残