React Native中WatermelonDB报错：Cannot read property 'collections' of undefined

以下是针对该错误的具体排查步骤：

1. 验证数据库Provider的配置 #

确保App根组件已正确包裹DatabaseProvider并传入初始化后的数据库实例：

import { DatabaseProvider } from '@nozbe/watermelondb'
import database from './src/database'

export default function App() {
  return (
    <DatabaseProvider database={database}>
      {/* 你的应用页面/组件 */}
    </DatabaseProvider>
  )
}

如果Provider未配置或传入的database实例为undefined，组件将无法获取到数据库对象，导致调用collections时出错

2. 检查withObservables的使用方式 #

函数组件场景 #

需通过useDatabase钩子正确获取数据库实例，再传入withObservables：

import { withObservables } from '@nozbe/watermelondb'
import { useDatabase } from '@nozbe/watermelondb/hooks'

function PostList({ posts }) {
  // 渲染逻辑
}

export default withObservables([], () => {
  const db = useDatabase()
  return {
    posts: db.collections.get('posts').query().observe()
  }
})(PostList)

类组件场景 #

需通过props传递数据库实例，或在高阶组件中确保能访问到db：

import { withObservables } from '@nozbe/watermelondb'

class PostList extends React.Component {
  // 组件逻辑
}

export default withObservables(['db'], ({ db }) => ({
  posts: db.collections.get('posts').query().observe()
}))(PostList)

注意：类组件无法直接使用useDatabase钩子，需通过props传递数据库实例

3. 确认数据库实例初始化正确性 #

检查数据库创建代码，确保SQLiteAdapter和schema配置无误：

import { Database } from '@nozbe/watermelondb'
import SQLiteAdapter from '@nozbe/watermelondb/adapters/sqlite'
import schema from './schema'
import Post from './models/Post'

const adapter = new SQLiteAdapter({
  schema,
  dbName: 'my_app_db',
  // 若有迁移逻辑需配置migrations
})

const database = new Database({
  adapter,
  modelClasses: [Post],
  actionsEnabled: true,
})

export default database

验证schema中的表名与模型的tableName属性完全一致，避免因名称不匹配导致的隐性错误

4. 种子数据填充时机检查 #

确保种子数据在数据库初始化完成后执行，避免提前调用数据库方法：

import { useEffect } from 'react'
import { useDatabase } from '@nozbe/watermelondb/hooks'
import seedDatabase from './seed'

function App() {
  const db = useDatabase()

  useEffect(() => {
    const seed = async () => {
      await seedDatabase(db)
    }
    seed()
  }, [db])

  return (
    <DatabaseProvider database={db}>
      {/* 组件内容 */}
    </DatabaseProvider>
  )
}

5. 定位错误来源 #

查看错误栈信息，找到触发collections调用的具体代码行，确认该行的数据库对象是否为undefined：

TypeError: Cannot read property 'collections' of undefined
at Object. (PostList.js:12:20)

比如上述错误指向PostList.js第12行，需检查该行的db变量是否已正确获取

内容的提问来源于stack exchange，提问作者Dario Adamović