Angular v16构建报错：link.parentNode.insertBefore is not a function

排查步骤： #

• 检查index.html的link标签结构
  先确认index.html里所有<link>标签有没有语法问题，比如未闭合、放错位置（比如不在<head>标签内）。构建时Angular的HTML解析逻辑对标签结构要求严格，异常结构会触发DOM操作报错。
• 清理第三方依赖残留配置
  就算卸载了jQuery和DataTables，可能还有残留配置没清干净：
  • 打开angular.json，检查scripts、styles数组里有没有相关依赖的路径，删掉残留项。
  • 查看tsconfig.json或tsconfig.app.json的types配置，要是还有jquery相关声明，直接移除后重试构建。
• 临时关闭HTML优化验证
  Angular构建默认会优化HTML，可能是优化逻辑出了问题。可以在angular.json的build配置里把optimization设为false，再执行ng build试试：

  "configurations": {
    "production": {
      "optimization": false
    }
  }
  

  如果能成功构建，再逐步开启优化，排查具体是哪个优化环节触发的问题。
• 检查自定义HTML处理逻辑
  有没有添加过自定义的webpack插件，或者使用了Angular的indexTransformer来处理index.html？先禁用这些自定义逻辑，看看是不是它们导致的DOM操作错误。
• 更新Angular CLI补丁版本
  可能是Angular CLI v16的某个版本bug，试试更新到同大版本的最新补丁：

  ng update @angular/cli @angular/core
  

• 彻底清理构建缓存
  执行以下命令清理缓存后重装依赖再构建：

  ng clean
  rm -rf node_modules package-lock.json
  npm install
  ng build
  

内容的提问来源于stack exchange，提问作者Francesco Cappellini