Nx升级至14.1.9后执行serve命令报TypeError: Cannot read property 'cloud'错误

错误原因 #

该错误是Nx Cloud任务运行器在读取配置时找不到预期的cloud属性，主要由以下情况引发：

• nx.json文件中tasksRunnerOptions配置缺失、格式错误，或cloud相关配置项未正确定义
• @nrwl/nx-cloud依赖版本与升级后的Nx（14.1.9）不兼容
• 依赖缓存（node_modules、yarn.lock）残留旧版本代码，导致配置读取逻辑冲突

解决步骤 #

• 修复nx.json配置
  打开项目根目录的nx.json文件，检查tasksRunnerOptions配置：

  • 若使用Nx Cloud，确保配置包含完整的cloud节点，示例：

    {
      "tasksRunnerOptions": {
        "default": {
          "runner": "@nrwl/nx-cloud",
          "options": {
            "cacheableOperations": ["build", "test", "lint"],
            "cloud": {
              "teamId": "你的团队ID",
              "appName": "你的应用名称"
            }
          }
        }
      }
    }
    

  • 若无需Nx Cloud，将runner替换为默认值并移除cloud配置：

    {
      "tasksRunnerOptions": {
        "default": {
          "runner": "@nrwl/workspace/tasks-runners/default",
          "options": {
            "cacheableOperations": ["build", "test", "lint"]
          }
        }
      }
    }
    

• 同步@nrwl/nx-cloud版本
  安装与Nx 14.1.9匹配的@nrwl/nx-cloud版本：

  yarn add @nrwl/nx-cloud@14.1.9 --dev
  

• 清理依赖并重新安装

  1. 删除旧依赖文件：

     rm -rf node_modules yarn.lock
     

  2. 重新安装依赖：

     yarn install
     

• 重新初始化Nx Cloud（如需使用）
  执行命令重新生成正确的Nx Cloud配置：

  yarn nx connect-to-nx-cloud
  

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