ASP.NET Core 8 MVC + Vite/Vue 发布至IIS后JS/CSS资源404问题求助

DevOps 小满

2026-4-7

看起来你遇到了挺头疼的部署问题——本地跑好好的，一发布到IIS就一堆资源404，明明文件都在wwwroot里对吧？我之前也帮不少人排查过类似的问题，给你梳理几个最常见的原因和解决办法，你可以逐一排查试试：

资源路径配置错误
本地开发时Vite服务器是根路径，但IIS部署时如果你的应用放在虚拟目录下（比如http://localhost/MyApp），Vite打包时的base路径就会不匹配。
解决步骤：
1. 打开vite.config.js，把base配置改成相对路径'./'，或者对应IIS虚拟目录的绝对路径（比如'/MyApp/'）。
2. 确保你在CSHTML里用vite.aspnetcore的标签助手引用资源，比如<vite-asset src="~/main.js" />，而不是硬写<script src="/main.js"></script>。标签助手会自动读取manifest.json里的正确路径（包括哈希后的文件名），避免路径错误。
IIS静态文件或MIME类型配置缺失
有时候IIS默认的静态文件处理模块没启用，或者某些资源的MIME类型没配置（比如Vite生成的.gz压缩文件、.js.map源映射文件），导致服务器无法识别这些资源返回404。
解决步骤：
1. 确认ASP.NET Core项目里已配置静态文件中间件：在Program.cs里要有app.UseStaticFiles();，且放在路由配置之前。
2. 登录IIS管理器，检查站点的“静态文件”功能是否启用；如果用了Vite的gzip压缩，需要给.gz添加MIME类型（类型填application/gzip）。
3. 可以先临时关闭Vite的压缩功能（在vite.config.js里设置build.compression = false），打包发布测试，排除压缩文件的问题。
发布时资源未完整复制
虽然你说wwwroot里有文件，但可能某些chunk文件在发布过程中没被正确复制到服务器输出目录。
解决步骤：
1. 打开.csproj项目文件，添加以下配置，确保wwwroot下所有文件都被复制到发布目录：
```
<ItemGroup>
  <Content Include="wwwroot/**/*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>
```
1. 检查Vite的build配置，确认output.dir设置为wwwroot，assetsDir（比如assets）配置正确，确保生成的资源都在wwwroot对应目录下。
vite.aspnetcore包的生产环境配置问题
这个包在开发和生产环境的配置逻辑不同，可能你没在生产环境启用manifest模式，导致无法正确读取资源路径。
解决步骤：
1. 在Program.cs里配置Vite服务时，明确指定生产环境使用manifest：
```
builder.Services.AddViteServices(options =>
{
    if (!builder.Environment.IsDevelopment())
    {
        options.Server.Manifest = "manifest.json";
        options.Server.BasePath = "/"; // 如果是虚拟目录，改成你的应用路径，比如"/MyApp/"
    }
});
```
1. 确认服务器上的wwwroot目录下确实存在manifest.json，且文件内容包含所有资源的正确路径和哈希值。

URL重写规则干扰静态资源请求
如果应用配置了URL重写规则（比如把所有请求导向MVC根路由），可能会把静态资源的请求也重定向，导致找不到文件。
解决步骤：

打开服务器上的web.config文件，检查重写规则，添加排除条件确保wwwroot下的静态资源不被重写：

<rule name="Skip Static Files" stopProcessing="true">
    <match url="^wwwroot/(.*)$" />
    <action type="None" />
</rule>

或者在现有重写规则里添加条件：

<rule name="Rewrite to MVC" stopProcessing="true">
    <match url=".*" />
    <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
        <add input="{URL}" pattern="^/wwwroot/" negate="true" />
    </conditions>
    <action type="Rewrite" url="/" />
</rule>

你可以按照这个顺序逐一排查，先从路径配置和标签助手的使用开始，这是最常见的问题。如果还是不行，可以看看浏览器控制台里的404请求具体路径，对比服务器上wwwroot里的实际文件路径，这样更容易定位问题。

内容来源于stack exchange