Ionic提示插件未安装求助：@ionic-native系列插件故障排查

我之前维护Ionic+Cordova项目时也碰到过一模一样的插件未安装报错，尤其是用新版本框架的时候，很容易因为版本兼容或者配置细节踩坑。结合我的排查经验，给你整理几个核心的修复方向：

1. 严格匹配@ionic-native/core与插件的版本 #

新版本Ionic（比如Ionic 6+）对@ionic-native的版本兼容性要求很高，如果@ionic-native/core和插件版本不一致，大概率会触发未安装提示。

• 先查看当前core版本：

  npm list @ionic-native/core
  

• 安装插件时指定和core一致的版本（比如core是5.36.0）：

  npm install @ionic-native/ibeacon@5.36.0
  npm install @ionic-native/estimate-beacons@5.36.0
  

  注意：部分@ionic-native插件的最新版本仅适配Capacitor而非Cordova，所以一定要选对应Cordova的稳定版本。

2. 确认底层Cordova原生插件已安装 #

@ionic-native只是Cordova原生插件的Angular封装层，如果原生插件没装，再完美的封装也会报错：

• 查看已安装的Cordova插件列表：

  cordova plugin list
  

• 如果找不到对应插件（比如cordova-plugin-ibeacon、cordova-plugin-ble-central），手动安装原生插件：

  cordova plugin add cordova-plugin-ibeacon
  cordova plugin add cordova-plugin-ble-central
  

3. 检查应用模块的配置是否正确 #

确保你在AppModule（或懒加载模块）里完成了正确的导入和配置：

• 导入插件的NgModule到imports数组：

  import { NgModule } from '@angular/core';
  import { IBeaconModule } from '@ionic-native/ibeacon/ngx';
  import { EstimateBeaconsModule } from '@ionic-native/estimate-beacons/ngx';
  
  @NgModule({
    imports: [
      // 其他模块
      IBeaconModule,
      EstimateBeaconsModule
    ]
  })
  export class AppModule { }
  

• 在需要使用的组件中注入对应的服务，不要直接实例化插件类。

4. 清理缓存并重建项目 #

缓存是这类问题的高发原因，彻底清理后重建往往能解决：

1. 删除依赖和锁文件：

   # macOS/Linux
   rm -rf node_modules package-lock.json
   # Windows
   rmdir /s /q node_modules && del package-lock.json
   

2. 重新安装依赖：

   npm install
   

3. 移除并重新添加平台（避免平台缓存）：

   cordova platform remove android
   cordova platform add android
   # iOS同理
   

4. 重新构建项目：

   ionic cordova build android
   

5. 验证配置文件完整性 #

• 检查config.xml中是否存在对应插件的条目，比如：

  <plugin name="cordova-plugin-ibeacon" spec="^3.8.0" />
  

• 确认package.json的dependencies里同时包含@ionic-native插件和对应的Cordova原生插件。

如果以上步骤都试过还是不行，建议检查项目的Ionic和Cordova版本是否过于超前（比如某些新特性还存在兼容性bug），可以尝试回退到稳定的小版本再测试。

内容的提问来源于stack exchange，提问作者ken.ng