Blazor Server部署至子目录后路径异常问题求助

1. 正确配置Program.cs #

核心是给应用设置路径基址，同时匹配配置Blazor Hub和回退页面的路由：

var app = builder.Build();

// 设置应用的路径基址
app.UsePathBase("/myapp");

// 静态文件中间件无需额外参数，UsePathBase会自动为其添加路径前缀
app.UseStaticFiles();

app.UseRouting();

// 配置Blazor Hub的路径，需包含路径基址
app.MapBlazorHub("/myapp/_blazor");
// 配置回退页面，同样要加上路径基址
app.MapFallbackToPage("/myapp/_Host");

app.Run();

2. 修正页面中的base标签和脚本引用 #

在_Host.cshtml（或_Layout.cshtml）中，用@Url.Content动态生成base href，确保开发和生产环境路径一致：

<base href="@Url.Content("~/")" />

同时将Blazor脚本的引用改为相对路径（去掉开头的斜杠）：

<script src="_framework/blazor.server.js"></script>

3. 配置Apache反向代理 #

确保Apache虚拟主机正确转发/myapp路径的请求，且完整保留路径信息：

<VirtualHost *:443>
    ServerName myserver

    # 将/myapp的请求转发到Blazor应用的Kestrel端口
    ProxyPass /myapp http://localhost:5000/myapp
    ProxyPassReverse /myapp http://localhost:5000/myapp

    # 以下为SSL相关配置，根据实际情况调整
    SSLEngine on
    SSLCertificateFile /path/to/certificate.crt
    SSLCertificateKeyFile /path/to/private.key
</VirtualHost>

配置完成后重启Apache服务：

sudo systemctl restart apache2

关键问题说明 #

• 之前设置app.UseStaticFiles("/myapp")是错误的，UsePathBase已经为所有后续中间件添加了路径前缀，静态文件中间件会自动处理/myapp下的静态资源请求。
• 未配置MapBlazorHub的路径会导致Blazor的SignalR连接失败，因为JS会根据base标签请求/myapp/_blazor，但Hub实际监听的是默认的/_blazor路径。
• 开发环境中，Visual Studio的开发服务器会自动处理路径基址，而生产环境需要明确配置应用和反向代理的路径规则，这就是两者表现差异的核心原因。

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