如何为混合模式C++/CLI库构建正确的NuGet包？

针对你需要同时支持32位自托管和64位IIS部署的场景，以及之前遇到的NuGet包架构不匹配警告、编译找不到托管代码等问题，下面是一套可行的解决方案：

1. 重构NuGet包结构（用单一包替代两个独立包） #

混合模式C++/CLI DLL的NuGet包需要同时满足编译时MSIL引用需求和运行时对应架构DLL加载需求，正确的包结构应该是这样的：

MyLibrary.nupkg
├── lib
│   └── net48  # 替换为你的项目实际依赖的.NET Framework版本，比如net472
│       └── MyLibrary.dll  # 空的MSIL占位DLL（仅保留与C++/CLI DLL一致的公共接口）
└── runtimes
    ├── win-x86
    │   └── native
    │       └── MyLibrary.dll  # 32位实际混合模式DLL
    └── win-x64
        └── native
            └── MyLibrary.dll  # 64位实际混合模式DLL

为什么需要占位DLL？ #

• 编译阶段：AnyCPU项目必须引用MSIL架构的程序集，否则会触发MSB3270架构不匹配警告；
• 运行阶段：NuGet会根据当前进程的架构（32/64位）自动从runtimes文件夹加载对应版本的实际混合模式DLL。

如何创建占位DLL？ #

用C#新建一个类库项目，编译为AnyCPU，然后定义与你的C++/CLI DLL完全一致的公共接口（类、方法、属性等），不需要写具体实现逻辑，只保留签名即可。例如：

public class MyManagedService
{
    public void ProcessData(string input);
    public int ComputeResult(int param1, int param2);
}

编译这个类库得到的DLL，就是/lib/net4xx/目录下的占位文件。

2. 配置ASP.NET Core项目 #

（1）引用单一NuGet包 #

删除之前的条件PackageReference，只添加对重构后的MyLibrary包的引用：

<PackageReference Include="MyLibrary" Version="1.0.0" />

（2）指定支持的运行时标识符 #

在项目的.csproj文件中添加RuntimeIdentifiers，明确声明支持32位和64位Windows环境：

<PropertyGroup>
  <RuntimeIdentifiers>win-x86;win-x64</RuntimeIdentifiers>
</PropertyGroup>

（3）运行时加载逻辑（可选） #

如果你的C++/CLI DLL有特殊依赖项，可以在项目启动时（比如Program.cs）添加简单的架构检测逻辑，但通常NuGet自带的运行时探测机制已经足够处理自动加载。

3. 适配不同部署场景 #

• IIS 64位部署：发布时指定RuntimeIdentifier为win-x64，或者直接发布AnyCPU包，确保IIS应用池设置为启用32位应用程序=False（默认就是64位）；
• 32位自托管部署：发布时指定RuntimeIdentifier为win-x86，或者直接在32位系统上运行AnyCPU发布包，Windows会自动加载32位版本的DLL。

4. 消除MSB3270警告 #

因为编译时引用的是MSIL架构的占位DLL，与AnyCPU项目的架构完全匹配，之前的MSB3270警告会自动消失，同时运行时会加载对应架构的实际C++/CLI DLL，不会出现运行时错误。

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