Salesforce LWC Lightning Modal dispatchEvent报错：参数非Event类型

针对API 56版本Lightning Modal中触发CustomEvent时出现的Failed to execute 'dispatchEvent' on 'EventTarget': parameter 1 is not of type 'Event'报错，以下是排查和解决步骤：

• 确认模态组件继承关系
  必须确保模态组件继承自LightningModal基类，而非普通的LightningElement。错误的继承会导致this上下文异常，无法正确触发事件。正确的类定义示例：

  import LightningModal from 'lightning/modal';
  
  export default class MyCustomModal extends LightningModal {
      handleSelectAction() {
          this.dispatchEvent(new CustomEvent('select', {
              detail: { id: 42 }
          }));
          this.close('confirm');
      }
  }
  

• 显式引入CustomEvent
  部分环境下可能存在CustomEvent未被自动识别的情况，需在模态组件中显式导入：

  import { CustomEvent } from 'lwc';
  import LightningModal from 'lightning/modal';
  
  export default class MyCustomModal extends LightningModal {
      // ... 组件逻辑
  }
  

• 父组件正确监听事件
  Lightning Modal通过API方式调用，父组件不能用模板绑定onselect的方式监听，必须通过open()方法返回的实例调用addEventListener：

  import MyCustomModal from 'c/myCustomModal';
  
  export default class ParentComponent extends LightningElement {
      async openCustomModal() {
          const modalInstance = await MyCustomModal.open({
              size: 'medium'
          });
          modalInstance.addEventListener('select', (event) => {
              console.log('获取到模态返回数据:', event.detail);
          });
      }
  }
  

• 清理缓存并重部署
  若以上步骤无效，清理浏览器缓存后重新部署组件，避免Salesforce缓存旧代码导致的异常。

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