react-native-sqlite-storage中db.executeSql未定义，如何执行SQL命令？

问题根源 #

你遇到的TypeError: db.executeSql is not a function主要有三个核心原因：

1. 异步函数未正确处理：connectToDatabase是async函数，直接赋值给db得到的是Promise对象，不是实际的数据库实例，自然没有executeSql方法。
2. SQL语句逻辑错误：检查表存在的SQL写法有误，且未使用参数绑定，存在安全隐患。
3. 组件渲染阶段执行异步逻辑：在函数组件渲染流程中直接调用异步函数，会导致逻辑执行时机错误，无法正确获取结果。

分步解决方案 #

1. 修正组件中的异步逻辑处理 #

组件中必须用useEffect包裹异步操作，通过await获取真实的数据库对象，同时用状态管理初始化结果：

import React, { useEffect, useState } from 'react';
import {Text, View} from 'react-native';
import {connectToDatabase, doesTableExist} from './code/DBAPI.js'
import {setupDBReceipts} from './code/DBAPI-receipts.js'
import {setupDBAttachments} from './code/DBAPI-attachments.js'

const App = () => {
    const [dbSetupStatus, setDbSetupStatus] = useState(null);

    useEffect(() => {
        const initDatabase = async () => {
            try {
                // 等待数据库连接完成，获取真实的db实例
                const db = await connectToDatabase();
                const tableExists = await doesTableExist(db, "Receipts");
                
                if(!tableExists){
                    await setupDBReceipts(db);
                    await setupDBAttachments(db);
                    setDbSetupStatus('firstTime');
                }else{
                    setDbSetupStatus('alreadyExists');
                }
            } catch (error) {
                console.error('数据库初始化失败:', error);
                setDbSetupStatus('error');
            }
        };

        initDatabase();
    }, []);

    if (dbSetupStatus === null) {
        return <View><Text>正在初始化数据库...</Text></View>;
    }

    if (dbSetupStatus === 'error') {
        return <View><Text>数据库初始化出错，请重试</Text></View>;
    }

    return (
        <View>
            <Text>
                {dbSetupStatus === 'firstTime' 
                    ? '欢迎使用应用，数据库已首次搭建完成 :)' 
                    : '欢迎使用应用，数据库已存在 :)'}
            </Text>
        </View>
    );
};

export default App;

2. 修正数据库工具类的SQL与异步逻辑 #

修正doesTableExist函数的SQL语句，使用参数绑定避免注入，同时正确处理executeSql的返回结果：

import {openDatabase} from "react-native-sqlite-storage";

/**
 * 连接应用数据库
 * @returns 数据库实例
 */
export const connectToDatabase = async() => {
    // 用Promise封装openDatabase的回调，统一异步逻辑
    return new Promise((resolve, reject) => {
        const db = openDatabase(
            {name: 'app.db', location: 'default'}, 
            () => resolve(db), 
            (error) => reject(error)
        );
    });
}

/**
 * 字符串 sanitize（待完善）
 * @param input 输入字符串
 * @returns 处理后的字符串
 */
export const sanitiseString = (input) => {
    return input; // 后续可补充XSS、SQL注入防护逻辑
}

/**
 * 检查数据库中是否存在指定表
 * @param db 数据库实例
 * @param tableName 表名
 * @returns 是否存在该表
 */
export const doesTableExist = async(db, tableName) => {
    tableName = sanitiseString(tableName);
    // 修正SQL语句，使用参数绑定避免注入
    const [resultSet] = await db.executeSql(
        "SELECT EXISTS(SELECT 1 FROM sqlite_schema WHERE type='table' AND name=?)",
        [tableName]
    );
    // 从结果集中提取判断值
    const row = resultSet.rows.item(0);
    return Object.values(row)[0] === 1;
}

给React Native新手的额外建议 #

• 先啃异步编程基础：JavaScript的async/await、Promise是React Native开发的核心，必须理解异步操作的执行逻辑，避免类似“直接拿Promise当实例用”的低级错误。
• 数据库操作必用参数绑定：永远不要用字符串拼接SQL语句，不仅容易出错，还会导致SQL注入风险，executeSql的第二个参数就是用来传绑定值的。
• 异步操作加错误处理：所有await的操作都要放在try/catch里，避免未处理的Promise拒绝错误，同时方便排查问题。
• 组件中异步逻辑放useEffect：函数组件的渲染阶段是同步的，异步操作必须放在useEffect中，配合useState管理状态，避免重复执行或渲染异常。
• 调试优先看控制台：React Native的错误信息会输出在终端或调试工具控制台，仔细看错误栈能快速定位问题，比如这次的错误其实已经提示db是undefined，说明你拿到的不是真实的数据库实例。

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