Lightning消息服务推送报错：找不到Lightning Component Bundle force-app

这个错误属于误导性提示，实际根源是messageChannel元数据的配置或部署流程问题，以下是针对性的排查和解决步骤：

1. 检查sfdx-project.json配置 #

确认项目配置文件里的包目录和API版本设置正确，确保force-app被正确识别为源码目录：

{
  "packageDirectories": [
    {
      "path": "force-app",
      "default": true
    }
  ],
  "name": "YourProjectName",
  "namespace": "",
  "sfdcLoginUrl": "https://login.salesforce.com",
  "sourceApiVersion": "59.0" // 需与目标Org的API版本匹配
}

• sourceApiVersion必须≥45.0（LMS的最低支持版本），且不能高于目标Org的API版本。

2. 验证Message Channel XML文件 #

检查lwcChannel.messageChannel-meta.xml的结构和API版本：

• 确保<apiVersion>与sfdx-project.json中的版本一致；
• 确认XML结构无语法错误，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
    <masterLabel>LWC Channel</masterLabel>
    <isExposed>true</isExposed>
    <description>用于组件间LMS通信的通道</description>
    <lightningMessageFields>
        <fieldName>recordId</fieldName>
        <description>传递的记录ID</description>
    </lightningMessageFields>
    <apiVersion>59.0</apiVersion>
</LightningMessageChannel>

3. 修正Package.xml（若使用MDAPI部署） #

如果是用传统MDAPI命令（而非SFDX源码推送）部署，确保package.xml正确包含LightningMessageChannel类型：

<types>
    <members>lwcChannel</members>
    <name>LightningMessageChannel</name>
</types>

• 注意：使用sfdx force:source:push时无需依赖package.xml，该文件仅用于MDAPI流程。

4. 清理本地缓存并重推 #

SFDX本地缓存可能导致元数据识别异常，执行以下命令：

# 清理本地缓存
sfdx force:source:clean
# 强制推送源码
sfdx force:source:push -f

5. 确认目标Org的API版本 #

检查目标Scratch Org/Dev Org的API版本是否兼容：

sfdx force:org:describe -u <你的Org别名> | grep "apiVersion"

如果Org的API版本低于项目配置的sourceApiVersion，需升级Org的API版本或降低项目的sourceApiVersion。

内容的提问来源于stack exchange，提问作者gab-dev