WatermelonDB 创建记录时遇到 "Not allowed to change record outside of create/update()" 错误的解决方案

问题现象

在使用 WatermelonDB 进行数据操作时，开发者可能会遇到一个常见的错误提示："Not allowed to change record outside of create/update()"。这个错误通常发生在尝试创建或更新数据库记录时，特别是在使用 create 方法时。

错误原因分析

这个错误的核心原因是 WatermelonDB 对数据修改操作有严格的上下文要求。WatermelonDB 要求所有的数据修改操作（创建、更新、删除）必须在特定的上下文环境中执行：

1. 必须在 database.write 事务块内执行
2. 必须在 create 或 update 方法的回调函数中进行字段赋值

正确用法示例

以下是创建记录的正确方式：

// 正确示例1：使用链式调用
const newUser = await database.get('users').create(user => {
  user.email = '[e-mail]';
  user.name = 'Test User';
});

// 正确示例2：在write事务块内执行
await database.write(async () => {
  await database.get('users').create(user => {
    user.email = '[e-mail]';
    user.name = 'Test User';
  });
});

常见错误模式

开发者容易犯的几个错误：

1. 在回调函数外部修改数据：

// 错误示例：在回调外部修改
const user = database.get('users').prepareCreate();
user.email = '[e-mail]'; // 这里会抛出错误

2. 忘记使用write事务块：

// 错误示例：缺少write事务
const user = await database.get('users').create(u => {
  u.email = '[e-mail]';
});

3. 配置问题： 如原问题中提到的，有时全局配置问题可能导致看似正确的代码也无法工作。这种情况下，重建项目可能是解决方案。

深入理解

WatermelonDB 的这种设计有几个优点：

1. 数据一致性：确保所有修改都在事务内完成
2. 性能优化：批量处理数据变更
3. 清晰的代码结构：强制开发者明确数据修改的上下文

解决方案总结

1. 确保所有数据修改操作都在 write 事务块内
2. 使用正确的链式调用语法
3. 所有字段赋值必须在 create 或 update 的回调函数内完成
4. 如遇奇怪问题，检查项目配置或考虑重建项目

通过遵循这些原则，可以避免 "Not allowed to change record outside of create/update()" 错误，并确保 WatermelonDB 操作的顺利进行。