CRA项目切换npm为Yarn后执行yarn start报HPM缺失target错误如何解决

克隆CRA（Create React App）项目仓库，将包管理工具从npm切换为Yarn后，执行yarn start命令启动项目时抛出报错：

[HPM] Missing "target" option. Example: {target: "http://www.example.org"}
error Command failed with exit code 1.

该报错由项目内置的http-proxy-middleware（缩写HPM，CRA用来配置开发环境代理的依赖）抛出，核心原因是代理配置中缺少必填的target（后端代理目标地址）参数，和npm切换Yarn的操作本身没有直接关联，切换包管理器后的依赖安装不完整、环境变量未正确加载是触发配置读取失败的常见诱因。

按以下顺序操作排查即可解决：

• 清理冗余文件后重装依赖
  先删除项目下的残留依赖文件、旧锁文件，再用Yarn重新完整安装依赖，执行命令如下：

  rm -rf node_modules yarn.lock package-lock.json
  yarn install
  

• 校验代理配置
  打开项目src目录下的setupProxy.js文件，确认所有代理规则都显式配置了有效的target值，正确配置示例：

  const { createProxyMiddleware } = require('http-proxy-middleware');
  
  module.exports = function(app) {
    app.use(
      '/api',
      createProxyMiddleware({
        // target为必填项，需填写本地开发对接的后端服务实际地址，禁止留空、传undefined
        target: 'http://127.0.0.1:3001',
        changeOrigin: true,
      })
    );
  };
  

  如果target是从环境变量读取（例如写法为target: process.env.REACT_APP_PROXY_TARGET），请检查项目根目录下的.env、.env.development等环境变量文件，确认对应变量存在且值正确，没有拼写错误。如果是克隆的团队项目，缺少本地环境变量文件时可以找项目维护者索要开发环境配置模板。
• 清缓存后重启项目
  执行命令清理Yarn缓存后重新启动即可：

  yarn cache clean
  yarn start
  

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