Ionic 3.20报错：Uncaught (in promise): cordova_not_available（已装Cordova）

这个cordova_not_available错误是Ionic/Cordova开发里非常常见的问题，核心原因是NativeGeocoder依赖Cordova的原生平台能力，而你当前的运行环境（比如浏览器）或者项目配置没有满足这个条件。下面是具体的解决步骤：

1. 确认NativeGeocoder插件及依赖包正确安装 #

首先检查你是否已经正确安装了Cordova插件和对应的Ionic Native包装器：

• 运行命令查看已安装的Cordova插件：

  ionic cordova plugin list
  

  如果看不到cordova-plugin-nativegeocoder，执行安装命令：

  ionic cordova plugin add cordova-plugin-nativegeocoder
  npm install @ionic-native/native-geocoder@4
  

  注意：Ionic 3必须使用@ionic-native的4.x版本，5.x及以上是为Ionic 4+设计的，版本不兼容会导致各种问题。

2. 不要在浏览器环境（ionic serve）中测试 #

NativeGeocoder是原生插件，浏览器不支持Cordova的原生API，所以你不能用ionic serve来测试这段代码。必须构建到iOS/Android模拟器或者真机上：

• 运行Android模拟器/真机：

  ionic cordova run android
  

• 运行iOS模拟器/真机（需要Mac环境）：

  ionic cordova run ios
  

3. 确保在AppModule中正确注册NativeGeocoder #

在Ionic 3中，所有Native插件都需要在app.module.ts中导入并添加到providers数组里，否则Angular无法注入这个服务：

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { IonicApp, IonicModule } from 'ionic-angular';
import { MyApp } from './app.component';

// 导入NativeGeocoder
import { NativeGeocoder } from '@ionic-native/native-geocoder';
import { ToastController } from 'ionic-angular'; // 确保ToastController也注册了

@NgModule({
  declarations: [
    MyApp
    // 你的页面组件
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp)
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp
    // 你的页面组件
  ],
  providers: [
    ToastController,
    NativeGeocoder, // 必须添加到这里
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

4. 用Platform.ready()包裹插件调用 #

Cordova的原生API只有在平台完全就绪后才能调用，所以你需要把Geocoder的代码放在Platform.ready()的回调里：

import { Component } from '@angular/core';
import { Platform, ToastController } from 'ionic-angular';
import { NativeGeocoder, NativeGeocoderReverseResult } from '@ionic-native/native-geocoder';

@Component({
  selector: 'page-home',
  templateUrl: 'home.html'
})
export class HomePage {

  constructor(
    private platform: Platform,
    private nativeGeocoder: NativeGeocoder,
    private toaster: ToastController
  ) {}

  getCountryFromCoords() {
    // 等待平台就绪后再调用插件
    this.platform.ready().then(() => {
      this.nativeGeocoder.reverseGeocode(52.5072095, 13.1452818)
        .then((result: NativeGeocoderReverseResult) => {
          const country = this.toaster.create({
            message: result.countryName,
            duration: 4000
          });
          country.present();
        })
        .catch(error => {
          console.error('反向地理编码失败:', error);
          // 可以在这里添加错误提示
        });
    });
  }
}

5. 清理并重建项目（如果以上步骤无效） #

有时候项目的缓存或者平台构建文件会有问题，尝试清理重建：

# 移除现有平台
ionic cordova platform remove android
# 重新添加平台
ionic cordova platform add android
# 重新构建
ionic cordova build android

按照这些步骤操作后，你的NativeGeocoder应该就能正常工作了。

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