部署Apex类时LWC元数据apiVersion解析错误求助

我创建了一个练习用LWC项目，执行命令sf project deploy start -d force-app/main/default/lwc可成功部署所有LWC组件；但执行sf project deploy start -d force-app/main/default/classes部署Apex类时，却提示所有已成功部署的LWC组件出现“Error parsing file: Element {http://soap.sforce.com/2006/04/metadata}apiVersion invalid at this location in type Document”错误。我的LWC组件存放在lwc目录，Apex类存放在classes目录。LWC的js-meta.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata" >

    <apiVersion>61.0</apiVersion>

    <isExposed>true</isExposed>

    <targets>

        <target>lightning__AppPage</target>

        <target>lightning__RecordPage</target>

        <target>lightning__HomePage</target>

    </targets>

</LightningComponentBundle>

环境信息：OS: win 11，Node.js: 20.8.1，sf: 2.29.5

以下是几个排查和解决方向：

• 检查Document元数据文件结构
  错误提示指向Document类型元数据的apiVersion位置无效，说明项目中可能存在结构错误的Document元文件（位于force-app/main/default/documents目录下）。Document的元数据要求apiVersion是顶级元素，不能嵌套在<Document>标签内，正确结构示例：

  <?xml version="1.0" encoding="UTF-8"?>
  <apiVersion>61.0</apiVersion>
  <Document xmlns="http://soap.sforce.com/2006/04/metadata">
      <name>示例文档</name>
      <contentFileName>sample.pdf</contentFileName>
  </Document>
  

  找到所有Document元文件，修正结构后重新部署Apex类。

• 升级sf CLI版本
  当前使用的sf CLI版本（2.29.5）可能存在目录扫描bug，导致部署classes时错误解析LWC元数据。执行以下命令升级到最新版本：

  sf update
  

  升级完成后重新尝试部署。

• 清理缓存后重新部署
  本地缓存可能导致元数据解析异常，执行带--clean参数的部署命令清理缓存：

  sf project deploy start -d force-app/main/default/classes --clean
  

• 检查sfdx-project.json配置
  确认sfdx-project.json中的packageDirectories配置是否正确，避免部署时意外包含无关目录。示例正确配置：

  {
      "packageDirectories": [
          {
              "path": "force-app",
              "default": true
          }
      ],
      "namespace": "",
      "sfdcLoginUrl": "https://login.salesforce.com",
      "sourceApiVersion": "61.0"
  }
  

• 检查目标Org中的同名Document
  如果目标Org中存在与LWC组件同名的Document记录，可能导致服务器混淆元数据类型。登录目标Org，删除同名Document后重新部署Apex类。

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