🐱 个人主页：不叫猫先生，公众号：前端舵手
🙋♂️ 作者简介：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 检查，你需要手动运行检查。
