🐱 个人主页：不叫猫先生，公众号：前端舵手
🙋‍♂️ 作者简介：CSDN博客专家、内容合伙人，2023新星计划导师，前端领域优质创作者，共同学习共同进步，一起加油呀！
📢 资料领取：前端进阶资料可以找我免费领取

Invalid Host header这个报错在网上有很多文章介绍解决办法，但是很多都没有没有用，这里为兄弟们排下坑，本文的解决方法已经验证没有问题，兄弟们可放心借鉴.

一、报错现象

在yarn serve 项目启动成功，但是页面显示Invalid Host header

二、报错原因分析

新版的webpack-dev-server出于安全考虑会默认检查hostname，用于防止不受信任的主机访问DevServer，当浏览器发出请求时，它会会检查请求中的主机头，若hostname 没有配置在内，则中断访问。

三、项目环境

Vue3：3.0.0
Npm：6.14.17
Node：16.13.0

四、解决方案

1、allowedHosts

设置allowedHosts，这个选项是设置允许访问开发服务器的主机列表。将其设置为 all 表示允许任何主机访问开发服务器。这个选项与主机检查相关，但它更精确地控制哪些主机可以访问开发服务器，而不是完全禁用主机检查。也可以设置多个主机。具体查看官方文档allowedHosts官方介绍

• 设置所有主机列表

allowedHosts: "all" 

• 设置部分主机列表

allowedHosts: ['xxx.com','xxx.com'] 

具体解决如下：

const { defineConfig } = require('@vue/cli-service') module.exports = defineConfig({   transpileDependencies: true,   lintOnSave: false,   devServer: {     host: 'localhost',      port: 8089,     historyApiFallback: true,     allowedHosts: "all"   } }) 

2、disableHostCheck

在vue-cli版本为2.x的情况下该设置生效，disableHostCheck允许在开发服务器中禁用主机检查。默认情况下，Webpack DevServer会检查请求的主机是否与配置中的主机匹配，以增加安全性。如果配置中没有明确指定主机（host），Webpack DevServer将只允许本地主机访问，以防止潜在的安全风险。通过将 disableHostCheck 设置为 true，可以允许来自其他主机的请求，但这可能会增加潜在的安全风险，因此谨慎使用。

const { defineConfig } = require('@vue/cli-service') module.exports = defineConfig({   transpileDependencies: true,   lintOnSave: false,   disableHostCheck:true,   devServer: {     host: 'localhost',      port: 8089   } }) 

如果vue-cli版本为3.x使用的时候会报下面的错误：

ValidationError: Invalid options object. Dev Server has been initialized using an options object that does not match the API schema.          - options has an unknown property 'disableHostCheck'. These properties are valid:            object { allowedHosts?, bonjour?, client?, compress?, devMiddleware?, headers?, historyApiFallback?, host?, hot?, http2?, https?, ipc?, liveReload?, magicHtml?, onAfterSetupMiddleware?, onBeforeSetupMiddleware?, onListening?, open?, port?, proxy?, server?, setupExitSignals?, setupMiddlewares?, static?, watchFiles?, webSocketServer? }  

所以需要看清自己的版本。

五、拓展

1、historyApiFallback

上面代码其中historyApiFallback用于在使用 Vue Router 或类似的前端路由库时，处理路由切换时的页面刷新问题。当你使用浏览器的前进和后退按钮或手动输入URL时，Vue Router或其他路由库会在前端进行路由切换，但如果没有合适的配置，刷新页面时会导致404错误。

historyApiFallback:true 

2、transpileDependencies

transpileDependencies用于配置需要通过 Babel 转译的依赖模块。默认情况下（false），Vue CLI 和 Babel 只会转译应用程序代码，而不会转译依赖模块（node_modules）中的代码。但有些依赖模块可能包含 ES6+ 语法，如果你需要转译这些依赖模块，可以使用 transpileDependencies 进行配置。但是transpileDependencies: true 只会广度遍历编译三方依赖，对于依赖的依赖则不会处理。

transpileDependencies:true 

transpileDependencies:['xxxx']//制定特定的依赖进行转译 

3、lintOnSave

lintOnSave 用于控制在开发和保存文件时是否执行 ESLint 静态代码检查。ESLint 可以帮助你捕获潜在的代码问题和风格违规。

如果将 lintOnSave 设置为 true，则在保存文件时，Vue CLI 会自动运行 ESLint 检查，如果发现问题，将会在开发过程中报告错误和警告。
如果将 lintOnSave 设置为 false，则禁用了自动的 ESLint 检查，你需要手动运行检查。