如何在树莓派（armv7）的Docker容器中运行ASP.NET 6 API

错误码分析 #

• 错误码132（SIGILL）：核心原因是指令集不兼容，比如编译生成的二进制文件与容器运行时的CPU架构不匹配，或者使用了当前CPU不支持的指令。
• 错误码130（SIGINT）：通常是进程启动失败后被系统终止，而非用户主动中断，本质还是启动环节的兼容性问题。

你的Dockerfile核心问题 #

1. Runtime与SDK版本不匹配：base镜像使用.NET 3.1的arm32v7运行时，但build阶段用的是.NET 6.0 SDK，跨大版本编译容易导致兼容性问题。
2. 架构选择不当：树莓派4 Model B原生支持arm64（aarch64）架构，你当前使用的arm32v7镜像可能无法充分利用硬件，甚至引发指令集冲突。
3. 发布参数不匹配：指定-r linux-arm（arm32）但运行环境可能是arm64，导致二进制文件无法正常执行。

针对性解决方案 #

第一步：确认项目TargetFramework #

打开API.csproj，查看<TargetFramework>节点的值，比如是netcoreapp3.1还是net6.0，后续镜像版本必须与此严格匹配。

第二步：调整Dockerfile（以.NET 6.0 + arm64为例） #

如果项目是.NET 6.0，修改后的Dockerfile如下：

# 使用匹配版本的arm64运行时镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0-bullseye-slim-arm64v8 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# 使用同版本的arm64 SDK镜像编译
FROM mcr.microsoft.com/dotnet/sdk:6.0-bullseye-slim-arm64v8 AS build
WORKDIR /src
COPY ["API/API.csproj", "API/"]
RUN dotnet restore "API/API.csproj"
COPY . .
WORKDIR "/src/API"
# 编译时指定arm64架构
RUN dotnet build "API.csproj" -c Release -o /app/build -r linux-arm64

FROM build AS publish
# 发布时匹配架构，若依赖框架部署可去掉--self-contained，否则加上
RUN dotnet publish "API.csproj" -c Release -o /app/publish -r linux-arm64 --self-contained false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "API.dll"]

如果项目是.NET 3.1，只需将镜像版本替换为3.1-bullseye-slim-arm64v8即可。

第三步：验证Docker架构支持 #

在树莓派上运行以下命令，确认Docker是否支持arm64：

docker info | grep Architecture

若输出为Architecture: aarch64，说明可以正常使用arm64镜像。

第四步：查看容器日志定位细节 #

如果调整后仍有问题，运行以下命令获取容器启动日志，进一步排查：

docker logs <你的容器ID或名称>

额外注意事项 #

• 避免跨大版本使用SDK和Runtime，比如用.NET 6 SDK编译.NET 3.1项目，可能引入隐性兼容性问题。
• 若坚持使用arm32架构，需确保树莓派系统是32位版本（树莓派OS默认有32/64位可选），但推荐使用arm64以发挥硬件性能。

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