如何在React Native应用的SQLite数据库中执行SQL脚本？

react-native-sqlite-storage 默认未开启多语句执行权限，单条SQL可正常运行是因为符合接口单语句入参要求，直接传入从Firebird导出的整段批量SQL脚本时，会因为包含多段分号分隔的语句、Firebird专属方言语法，出现只执行第一条、语法报错、执行中断的问题。

• 第一步：预处理WinForms端导出的SQL文件，做方言兼容裁剪
  删掉所有SQLite不识别的Firebird专属语法：包括SET TERM语句、存储过程/触发器定义、序列生成指令、专属事务声明；移除所有--开头的单行注释、/* */包裹的多行注释；修正类型不匹配的语法：将Firebird的布尔值TRUE/FALSE替换为1/0，日期值转换为SQLite支持的TEXT时间串或数值时间戳，移除非SQLite标准的字段约束。
• 第二步：初始化数据库时开启多语句支持
  打开数据库连接时传入enableMultiLineStatements: true配置，否则原生端会拦截多语句执行请求，示例代码：

  import SQLite from 'react-native-sqlite-storage';
  SQLite.enablePromise(true);
  
  const db = await SQLite.openDatabase({
    name: 'app.db',
    location: 'default',
    enableMultiLineStatements: true // 核心配置
  });
  

  注意：即使开启该配置，也不要直接将超过1MB的SQL整段传入执行，容易触发JS线程内存溢出、原生端执行超时。
• 第三步：拆分SQL+事务包裹执行（全版本兼容最稳方案）
  把预处理后的SQL内容按分号拆分（注意跳过字段值字符串内部的分号，避免把值内容截断），过滤空语句、手动开启事务批量顺序执行，全部成功后提交，出错直接回滚，执行效率比循环单条插入高10~100倍，参考代码：

  // 读取本地存储的预处理后SQL文件内容
  const sqlContent = await readLocalFile(importSqlPath, 'utf8');
  // 拆分语句
  const stmtList = sqlContent
    .split(';')
    .map(s => s.trim())
    .filter(s => {
      if (!s) return false;
      if (s.startsWith('--')) return false;
      const upperS = s.toUpperCase();
      // 跳过自带的事务声明，用我们手动控制的事务
      if (['BEGIN', 'COMMIT', 'ROLLBACK'].includes(upperS)) return false;
      return true;
    });
  
  await db.transaction(async (tx) => {
    for (const stmt of stmtList) {
      try {
        await tx.executeSql(stmt);
      } catch (e) {
        console.log('执行失败语句:', stmt);
        throw e; // 抛出错误触发全量回滚
      }
    }
  });
  

• 第四步：超大数据量优化
  如果待导入数据超过1万条，把零散的单条INSERT语句合并为多值插入格式：例如将INSERT INTO user(id,name) VALUES(1,'a');INSERT INTO user(id,name) VALUES(2,'b');合并为INSERT INTO user(id,name) VALUES(1,'a'),(2,'b');，单条语句批量插入可以进一步压缩执行时间，注意单条拼接后的SQL长度不要超过1MB，避免触发SQLite语句长度限制。

• 预处理完的SQL建议先在桌面端SQLite客户端跑一遍验证语法，确认没有方言兼容问题再放到RN端执行，减少端上调试成本
• iOS端内置的SQLite版本语法校验比Android端更严格，不要使用SQLite新版本才支持的特殊语法
• 导入超过10MB的SQL文件时，建议加进度回调提示，不要在JS线程做同步解析，避免触发系统ANR弹窗。

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