.NET 6升级至.NET 8后Blazor WASM容器化部署出现异常

问题根源 #

容器环境中可能残留了.NET 6的旧构建产物，或是NGINX配置未适配.NET 8的静态资源缓存规则，导致浏览器加载了过时的Blazor运行时文件。本地清缓存能解决是因为直接清理了客户端缓存，但容器端的旧文件未被彻底替换。

修复方案 #

1. 彻底清理Docker构建缓存，构建全新镜像 #

Docker的层缓存可能复用了.NET 6的旧文件，需强制重新构建：

docker build --no-cache -t MyApp .

2. 修正NGINX配置，适配.NET 8缓存策略 #

在nginx.conf中对Blazor核心文件设置严格的缓存控制，避免浏览器缓存旧资源：

server {
    listen 80;
    location / {
        root /usr/share/nginx/html;
        try_files $uri $uri/ /index.html =404;
        
        # 禁止缓存Blazor运行时核心文件
        location ~* \.(wasm|blazor\.webassembly\.js)$ {
            expires -1;
            add_header Cache-Control "no-cache, no-store, must-revalidate";
            add_header Pragma "no-cache";
            add_header Expires "0";
        }
    }
}

3. 优化Dockerfile，确保产物完全替换 #

修改Dockerfile，在复制构建产物前清空NGINX的目标目录，避免旧文件残留：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourProject.csproj", "."]
RUN dotnet restore "./YourProject.csproj"
COPY . .
RUN dotnet publish "YourProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段
FROM nginx:alpine
WORKDIR /usr/share/nginx/html
# 清空目录再复制新产物
RUN rm -rf ./*
COPY --from=build /app/publish .
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80

4. 修正容器启动命令的参数顺序 #

之前的启动命令参数顺序错误，-p映射需放在镜像名之前：

docker run -p 5001:80 MyApp

（注：NGINX默认监听容器内80端口，因此映射主机5001到容器80即可）

5. 客户端强制刷新缓存 #

容器修复后，客户端浏览器可能仍缓存旧资源，按Ctrl+Shift+R强制刷新页面，或在URL后添加版本参数（如localhost:5001/?v=1）临时绕过缓存。

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