.NET Framework 4.6.1中NuGet包公共静态类及方法无法访问

问题场景 #

基于.NET Framework 4.6.1开发的C# NuGet包，被同版本框架的VB.NET遗留项目引用。该项目已正常使用另外三个同作者的NuGet包，但新增此包后，调用其公共静态类的方法时编译报错：“未声明，可能因访问级别问题无法访问”。仅引用包不调用方法时项目可正常构建，调用后构建失败，输出仅提示“未找到/无法访问”，怀疑和Wait()调用有关。

已尝试的操作 #

• 删除BIN/OBJ文件夹，清理并重新生成解决方案
• 升级NuGet包版本，排除旧引用残留问题
• 添加Json相关依赖包
• 移除并重新添加NuGet包引用

代码示例 #

NuGet包中的C#代码 #

public static class ClassInNugetPackage
{
    public static async Task Initialize(string customerNumber, int locationId)
    {
        await SystemState.Instance.Initialize(customerNumber, locationId);
    }

    public static async Task SetApiUrl(string url)
    {
        await SystemState.Instance.SetApiUrl(url);
    }
}

VB.NET项目中的调用代码 #

Public Sub New()
    InitializeComponent()

    Dim customerNumber = "170"
    Dim customerLocationId = 2140
    NamespaceInNugetPackage.ClassInNugetPackage.SetApiUrl("https://localhost:7012").Wait()
    NamespaceInNugetPackage.ClassInNugetPackage.Initialize(customerNumber, customerLocationId).Wait()

    If ClassInNugetPackage.BooleanValue.IsEnabled Then
        MsgBox("Yes!")
    End If
    
    ...
End Sub

排查与解决方案 #

1. 确认命名空间引用正确性 #

VB.NET对命名空间的解析逻辑与C#存在细微差异：

• 在VB文件顶部添加命名空间导入：Imports NamespaceInNugetPackage，简化调用的同时避免命名空间拼写错误
• 核对C# NuGet包中类的完整命名空间，确保调用时的命名空间与包中完全一致（注意嵌套命名空间的层级）

2. 调整异步方法调用方式 #

虽然Task类型跨语言兼容，但VB.NET的类型推断逻辑可能对链式调用Wait()存在解析问题：

• 拆分调用步骤，先将异步方法返回值赋值给显式声明的Task变量：

  Dim setUrlTask As Task = NamespaceInNugetPackage.ClassInNugetPackage.SetApiUrl("https://localhost:7012")
  setUrlTask.Wait()
  Dim initTask As Task = NamespaceInNugetPackage.ClassInNugetPackage.Initialize(customerNumber, customerLocationId)
  initTask.Wait()
  

• 若允许调整构造函数逻辑，可将异步调用封装为异步初始化方法（注意构造函数中使用异步需规避死锁风险）：

  Public Sub New()
      InitializeComponent()
      InitializeAsync().Wait()
  End Sub
  
  Private Async Sub InitializeAsync()
      Dim customerNumber = "170"
      Dim customerLocationId = 2140
      Await NamespaceInNugetPackage.ClassInNugetPackage.SetApiUrl("https://localhost:7012")
      Await NamespaceInNugetPackage.ClassInNugetPackage.Initialize(customerNumber, customerLocationId)
      
      If NamespaceInNugetPackage.ClassInNugetPackage.BooleanValue.IsEnabled Then
          MsgBox("Yes!")
      End If
  End Sub
  

3. 检查NuGet包的可见性与输出配置 #

• 确认C# NuGet包项目的输出类型为类库（Class Library），且ClassInNugetPackage类及方法的访问修饰符确实为public（无编译条件如#if导致的访问级别变更）
• 检查NuGet包的.nuspec文件或打包配置，确保所有必要的依赖DLL都被包含，没有遗漏核心程序集

4. 调整VB.NET项目编译选项 #

• 检查项目“编译选项”中的严格模式是否开启，严格模式下类型推断更严格，可能导致Task类型解析失败，可尝试关闭后重新编译测试
• 确认VB项目的目标框架确实为.NET Framework 4.6.1，未误配置为其他版本

5. 验证类的可访问性 #

先尝试仅引用类而非调用方法，判断是类无法访问还是方法问题：

' 测试类是否可被识别
Dim testType As Type = GetType(NamespaceInNugetPackage.ClassInNugetPackage)

若此代码编译通过，说明类可访问，问题集中在方法调用的类型解析上；若仍报错，则需排查NuGet包的引用或可见性配置。

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