PocketBase数据库初始化与集合创建的最佳实践

概述

在使用PocketBase进行开发时，许多开发者会遇到在应用启动时自动创建数据库集合的需求。本文将通过一个典型错误案例，深入分析PocketBase的初始化机制，并提供两种可靠的解决方案。

常见错误分析

开发者尝试在onAfterBootstrap钩子中创建集合时，经常会遇到"no such table: _collections"的错误。这是因为：

1. PocketBase的系统迁移（包括创建内部表如_collections）是在应用启动的后期阶段执行的
2. onAfterBootstrap钩子触发时，系统表尚未完全初始化
3. 直接操作DAO(Data Access Object)时，依赖的系统表不存在导致操作失败

解决方案一：使用迁移脚本

PocketBase提供了专门的迁移机制来解决这类初始化问题。以下是创建用户设置集合的推荐做法：

// 在pb_migrations目录下创建迁移文件，如1687801090_initial_schema.js
migrate((db) => {
    const dao = new Dao(db);
    
    const settings = new Collection({
        name: 'settings',
        type: 'base',
        schema: [
            {
                name: 'name',
                type: 'text',
                required: false,
                options: {
                    min: null,
                    max: null,
                    pattern: ''
                }
            },
            {
                name: 'current_setting',
                type: 'json',
                required: false,
                options: {}
            }
        ]
    });

    dao.saveCollection(settings);
}, (db) => {
    // 回滚逻辑
    const dao = new Dao(db);
    dao.deleteCollection('settings');
});

迁移脚本的优势：

• 在系统完全初始化后执行
• 支持版本控制和回滚
• 是PocketBase推荐的数据库变更方式

解决方案二：延迟执行创建逻辑

如果必须使用钩子，可以考虑延迟执行集合创建操作：

onAfterBootstrap(() => {
    setTimeout(() => {
        // 延迟执行确保系统表已初始化
        const collection = new Collection({
            // 集合配置
        });
        $app.dao().saveCollection(collection);
    }, 1000); // 适当延迟
});

最佳实践建议

1. 对于生产环境，强烈建议使用迁移脚本
2. 迁移文件名应包含时间戳前缀以保证执行顺序
3. 复杂的初始化逻辑可以拆分为多个迁移文件
4. 始终为迁移编写回滚逻辑
5. 测试环境可以使用钩子方式快速迭代

总结

理解PocketBase的初始化流程对于正确创建数据库集合至关重要。通过迁移脚本机制，开发者可以可靠地在系统完全初始化后执行数据库操作，避免常见的"表不存在"错误。本文提供的两种方案各有适用场景，开发者应根据项目需求选择合适的方法。