ASP.NET Core 6.0 SPA被外部调用时触发InvalidOperationException问题

核心原因 #

当应用被外部程序调用时，工作目录不匹配是最常见的诱因——外部程序默认会以自身目录作为工作目录启动你的应用，导致ASP.NET Core无法定位到React构建后的index.html及静态资源。

解决方案 #

1. 强制指定SPA静态文件路径 #

修改UseSpa配置，明确指定React构建产物的物理路径，不依赖当前工作目录：

app.UseSpa(spa =>
{
    spa.Options.SourcePath = "ClientApp"; // 你的React项目根目录
    // 硬编码静态文件的物理路径
    spa.Options.DefaultPageStaticFileOptions = new StaticFileOptions
    {
        FileProvider = new PhysicalFileProvider(
            Path.Combine(Directory.GetCurrentDirectory(), "ClientApp", "build"))
    };

    if (env.IsDevelopment())
    {
        spa.UseReactDevelopmentServer(npmScript: "start");
    }
});

注意：确保发布或编译后ClientApp/build目录存在且包含完整的React构建文件。

2. 修正外部程序的调用逻辑 #

要求调用方启动应用时，将工作目录设置为你的应用发布目录：

• CMD调用示例：

cd /d "C:\YourApp\PublishedPath"
YourApp.exe

• C#调用示例：

var startInfo = new ProcessStartInfo("YourApp.exe")
{
    WorkingDirectory = @"C:\YourApp\PublishedPath",
    UseShellExecute = false
};
Process.Start(startInfo);

3. 应用启动时强制重置工作目录 #

在Program.cs开头添加代码，将工作目录强制设置为应用程序所在目录：

using System.Reflection;

// 重置工作目录到程序集所在路径
var assemblyDir = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
if (!string.IsNullOrEmpty(assemblyDir))
{
    Directory.SetCurrentDirectory(assemblyDir);
}

var builder = WebApplication.CreateBuilder(args);
// ... 后续配置代码

这能彻底规避外部调用时的工作目录问题。

4. 确保发布配置包含React构建产物 #

在项目的.csproj文件中添加以下配置，确保build目录的文件被复制到输出目录：

<ItemGroup>
  <Content Include="ClientApp\build\**">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

发布前务必执行npm run build生成最新的React构建文件。

额外排查手段 #

• 用Process Monitor工具跟踪应用的文件访问请求，查看它实际在哪个目录下查找index.html，快速定位路径错误。
• 检查外部调用时的环境变量，确认是否误设置了ASPNETCORE_ENVIRONMENT=Production但未完成完整发布。

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