跟随2020年教程开发Ionic+Capacitor SQLite应用遇报错求助

核心原因：Ionic/Capacitor生态四年间确实发生了重大版本迭代，2020年的旧教程API写法已完全不兼容最新版本 #

你遇到的错误本质是Storage和SQLite插件的API调用方式、类型定义都发生了根本性变化，具体细节如下：

• Storage插件的变化
  2020年教程使用的旧版@ionic/storage支持静态方法直接调用（如Storage.get()），但现在最新的@ionic/storage-angular需要依赖注入实例化后调用，且API参数简化；即使使用Capacitor原生@capacitor/storage，严格TypeScript模式下也要求用索引访问方式（Storage['get']()），但这并非推荐写法。
• SQLite插件的变化
  旧版capacitor-sqlite已被官方社区维护的@capacitor-community/sqlite替代，打开数据库的API从CapacitorSQLite.open()改为通过SQLiteConnection服务创建连接，参数结构也完全不同。

代码修正示例（适配最新版本） #

假设使用@ionic/storage-angular和@capacitor-community/sqlite，调整后的服务代码大致如下：

import { Injectable } from '@angular/core';
import { Storage } from '@ionic/storage-angular';
import { SQLiteConnection, SQLiteDBConnection } from '@capacitor-community/sqlite';
import { BehaviorSubject } from 'rxjs';

@Injectable({ providedIn: 'root' })
export class DatabaseService {
  private storageInstance: Storage | null = null;
  private dbReady = new BehaviorSubject<boolean>(false);
  private dbName = 'app_db';
  private readonly DB_SETUP_KEY = 'db_setup_done';
  private readonly DB_NAME_KEY = 'db_name';

  constructor(
    private storage: Storage,
    private sqliteConnection: SQLiteConnection
  ) {
    this.initStorage();
  }

  private async initStorage() {
    this.storageInstance = await this.storage.create();
    await this.setupDatabase();
  }

  private async setupDatabase() {
    const dbSetupDone = await this.storageInstance?.get(this.DB_SETUP_KEY);

    if (!dbSetupDone) {
      await this.initializeDatabase();
    } else {
      this.dbName = await this.storageInstance?.get(this.DB_NAME_KEY) || this.dbName;
      const db = await this.getDatabaseConnection();
      await db.open();
      this.dbReady.next(true);
    }
  }

  private async initializeDatabase() {
    // 这里替换为你的数据库初始化逻辑（如下载、建表）
    const db = await this.getDatabaseConnection();
    await db.open();
    // 示例：创建表
    await db.execute('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)');
    
    // 标记初始化完成
    await this.storageInstance?.set(this.DB_SETUP_KEY, true);
    await this.storageInstance?.set(this.DB_NAME_KEY, this.dbName);
    this.dbReady.next(true);
  }

  private async getDatabaseConnection(): Promise<SQLiteDBConnection> {
    return await this.sqliteConnection.createConnection(
      this.dbName,
      false,
      'no-encryption',
      1
    );
  }
}

关于资源的建议 #

完全放弃2020年的旧教程，直接参考最新官方资源：

• Ionic官网的Storage和SQLite相关教程
• Capacitor官方文档的插件使用说明
• @capacitor-community/sqlite的官方文档

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