.NET 8 Blazor WASM发布至Linux容器后SignalR连接报错求助

错误信息 #

Could not resolve type with token 01000042 from typeref (expected class 'System.IAsyncDisposable' in assembly 'netstandard, Version=2.1.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51') assembly:netstandard, Version=2.1.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51 type:System.IAsyncDisposable member:(null)

可能原因及解决步骤 #

1. 自包含发布RID不匹配 #

发布时未指定Linux目标运行时标识符（RID），导致生成的二进制文件与容器环境不兼容。

• 执行发布命令时明确指定RID：

  dotnet publish -c Release -r linux-x64 --self-contained true
  

• 或在client.csproj的<PropertyGroup>中添加默认RID配置：

  <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
  

2. 冗余netstandard.dll导致解析冲突 #

Blazor WASM基于.NET 8运行时，无需携带netstandard.dll，该文件的存在会干扰运行时类型解析逻辑。

• 手动删除发布目录中的netstandard.dll
• 或在client.csproj中配置阻止该文件被复制到输出目录：

  <ItemGroup>
    <Content Remove="netstandard.dll" />
  </ItemGroup>
  

3. 依赖包版本不一致 #

客户端Microsoft.AspNetCore.SignalR.Client版本为8.0.15，服务端多数官方包版本为8.0.8，版本差异可能引发依赖解析冲突。

• 将所有.NET官方包统一至相同的8.0.x版本（如8.0.15），确保依赖链的兼容性。

4. 容器运行环境异常 #

手动安装的.NET运行时可能存在文件缺失或配置异常，建议使用官方维护的ASP.NET Core 8.0镜像作为容器基础：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["client/client.csproj", "client/"]
COPY ["server/server.csproj", "server/"]
RUN dotnet restore "server/server.csproj"
COPY . .
WORKDIR "/src/server"
RUN dotnet build "server.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "server.csproj" -c Release -r linux-x64 --self-contained true -o /app/publish /p:UseAppHost=true

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["./server"]

5. 排查第三方依赖的netstandard引入 #

使用命令查看客户端项目的所有依赖（包括传递依赖），找出强制引入netstandard的包：

dotnet list client/client.csproj package --include-transitive

更新该包至支持.NET 8的版本，或排除不必要的依赖项。

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