如何构建可正常运行的ASP.NET项目Nix包？解决静态资源404问题

问题现象 #

使用buildDotnetModule构建项目并通过environment.systemPackages安装后，网站运行时静态资源（比如css/site.css）返回404：

Request finished HTTP/2 GET https://my.app/css/site.css - 404 0

核心问题大概率是wwwroot目录未被正确复制到构建产物，或者程序无法识别其路径。

解决步骤 #

• 检查项目文件的静态资源配置
  确保你的.csproj里已经配置了将wwwroot下的文件复制到输出目录：

  <ItemGroup>
    <Content Include="wwwroot/**/*">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
  </ItemGroup>
  

  这是.NET项目默认配置，但如果被修改过需要恢复。

• 确认Nix构建时未排除静态资源
  检查buildDotnetModule的配置，确保dotnetFlags没有添加会忽略静态资源的参数，比如--no-build之类的不当配置。如果项目是发布模式构建，默认应该会包含静态资源，但可以显式指定：

  buildDotnetModule {
    # 其他配置
    dotnetFlags = [ "--configuration Release" ];
  }
  

• 手动在构建后复制wwwroot
  如果自动复制失效，在buildDotnetModule中添加postBuild步骤手动复制：

  buildDotnetModule {
    pname = "myapp";
    version = "1.0.0";
    src = ./.;
    projectFile = "MyApp.csproj";
    # 其他配置...
    postBuild = ''
      cp -r ./wwwroot $out/lib/net6.0/
    '';
  }
  

  替换net6.0为你的项目实际目标框架版本。

• 确保程序能正确找到静态资源路径
  在ASP.NET Core的启动代码（Program.cs/Startup.cs）中，显式指定静态文件的根目录：

  var builder = WebApplication.CreateBuilder(args);
  // 其他配置...
  var app = builder.Build();
  app.UseStaticFiles(new StaticFileOptions
  {
      FileProvider = new PhysicalFileProvider(
          Path.Combine(AppContext.BaseDirectory, "wwwroot")),
      RequestPath = ""
  });
  // 其他中间件配置...
  app.Run();
  

  或者运行程序时通过环境变量指定内容根目录：

  DOTNET_CONTENT_ROOT=$(dirname $(which myapp))/../lib/net6.0 myapp
  

• 验证安装后的文件结构
  安装后到Nix存储目录查看（比如/nix/store/<hash>-myapp/lib/net6.0/），确认wwwroot存在且资源完整，这能快速定位是构建问题还是运行时路径问题。

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