Ionic Serve报错：Schema验证失败，存在额外属性es5BrowserSupport

报错由两个不兼容问题共同触发：

• 当前运行的Node.js v17.1.0为奇数非LTS版本，未经过Ionic、Angular生态兼容性验证，极易出现依赖运行异常
• 项目配置中残留了当前Angular版本已废弃移除的es5BrowserSupport字段，触发CLI配置规则校验失败

1. 替换兼容的Node.js版本

• 完全卸载当前Node.js 17.x版本，安装Node.js 16.x或18.x LTS偶数版本
• 安装完成后执行node -v确认版本符合要求，再执行npm install -g npm@8将npm升级到对应稳定版本

2. 清理废弃配置

• 打开项目根目录下的angular.json文件，全局搜索es5BrowserSupport字段，删除所有匹配到的字段及对应值
• 删除项目根目录下的node_modules文件夹和package-lock.json文件，执行npm install重新拉取安装依赖

3. 启动验证

• 依赖安装完成后执行ionic serve即可正常启动
• 如果启动后出现websocket连接异常，追加启动参数即可：ionic serve --host=0.0.0.0 --disable-host-check

1. 基础依赖安装

• 安装Node.js 18.x LTS版本，该版本为当前Ionic官方验证兼容的长期支持版本
• 可选配置国内npm镜像提升依赖下载速度，执行对应镜像源提供的配置命令即可
• 全局安装匹配版本的CLI工具：

npm install -g @ionic/cli@7 @angular/cli@16

• 安装完成后分别执行ionic -v、ng version，无报错则说明全局工具安装正常

2. 环境有效性验证

• 执行新建项目命令创建测试项目：

ionic start test-demo blank --type=angular

• 进入项目目录执行ionic serve，若能正常加载默认启动页，说明环境版本完全匹配无冲突

3. 旧项目运行注意事项

• 导入已有旧项目前，先确认项目初始化时对应的Ionic、Angular大版本，安装对应大版本的CLI工具后再运行，避免跨大版本CLI的配置不兼容问题
• 旧项目升级需逐版本迭代依赖，不要直接用最新版CLI运行多年前创建的低版本项目

内容的提问来源于stack exchange，提问作者Daniel Da Cruz