Capacitor iOS本地插件调用返回UNIMPLEMENTED错误排查求助

各位好，我现在在开发一个Angular + Capacitor的iOS应用，尝试用一个简单的原生插件（类似官方的Echo示例），但一直碰到UNIMPLEMENTED错误，实在摸不着头绪，来求助大家！

我的开发背景与操作细节 #

• 技术栈：Angular + Capacitor iOS
• 插件实现方式：没有用官方的npx @capacitor/plugin generate生成独立插件包，而是手动创建了Swift文件，直接放到Xcode项目里（和AppDelegate.swift同目录）
• 插件代码核心配置：
  • 插件类EchoPlugin实现了CAPPlugin和CAPBridgedPlugin，正确定义了echo方法
  • 配套的Echo.swift里是最基础的逻辑：返回传入的字符串
  • 类上标注了@objc(EchoPlugin)，pluginMethods配置正确，jsName设为"Echo"，和前端registerPlugin("Echo")的名称完全匹配
• 前端调用代码：

  const Echo = registerPlugin('Echo');
  Echo.echo({ value: 'test' });
  

• 插件注册的尝试：
  1. 在AppDelegate.swift手动注册：bridge?.registerPluginInstance(EchoPlugin())
  2. 尝试让Capacitor自动检测插件
  3. 还在capacitor.config.ts里添加了配置：

  plugins: {
    EchoPlugin: {}
  }
  

• 常规操作都做了：执行过npx cap sync ios，用npx cap open ios打开项目，确认Swift文件已经包含在App target里，多次清理构建文件夹并重新构建项目

遇到的具体问题 #

每次调用Echo.echo({ value: 'test' })，都会返回这个错误：

{"code":"UNIMPLEMENTED"}

更奇怪的是Xcode控制台完全没有任何输出，感觉原生方法根本没被调用到。

我已经排查过的点 #

• 确认插件类的@objc标注、CAPBridgedPlugin实现、pluginMethods配置都没问题
• jsName和前端registerPlugin的名称完全一致
• Swift文件确实已经加入到App的target中
• 试过手动注册和自动检测两种插件注册方式，结果都一样
• 多次执行cap sync、清理构建缓存、重新构建项目
• 在capacitor.config.ts里配置了插件项

预期与实际结果对比 #

• 预期：调用Echo.echo能返回传入的test字符串，同时Xcode控制台能看到Swift方法里的日志输出
• 实际：返回UNIMPLEMENTED错误，Xcode控制台无任何日志输出

想请教大家：直接把Swift插件文件加到Xcode项目里，有没有什么我漏掉的特殊配置？为什么会出现这个问题呢？

内容来源于stack exchange