删除Webpack html插件后Vue项目首页返回‘Cannot GET /’求助

云原生阿岚

2026-8-19

问题分析与解决：删除html插件导致首页Cannot GET /

问题原因

Vue CLI默认集成的html插件（基于html-webpack-plugin）负责生成项目的入口HTML文件（如index.html），开发服务器正是通过这个文件作为访问入口。当执行config.plugins.delete('html')删除该插件后，服务器找不到对应的入口HTML，因此访问根路径/时会返回Cannot GET /。
仅删除preload和prefetch插件时，html插件仍在正常工作，能生成所需的入口HTML文件，所以项目可以正常运行。

解决方案

常规场景（保留入口HTML）

不要删除html插件，仅删除preload和prefetch即可。如果需要调整HTML相关配置，可通过修改html插件的参数实现，示例如下：

chainWebpack: config => {
    config.plugins.delete('preload')
    config.plugins.delete('prefetch')
    
    // 自定义html插件配置示例
    config.plugin('html').tap(args => {
        // 修改页面标题
        args[0].title = '我的自定义页面'
        // 可添加其他配置，比如注入自定义脚本等
        return args
    })
}