PocketBase中管理员批量创建记录时的并发问题解析

在使用PocketBase进行数据操作时，管理员用户可能会遇到一个特殊的并发问题：当尝试使用Promise.all()同时创建多条记录时，部分请求会被意外中止。本文将深入分析这一现象的原因，并提供解决方案。

问题现象

当管理员用户通过JavaScript SDK执行以下操作时：

const createTwoTest = [1, 2].map(async (i) => {
  return adminPb.collection('test').create({
    field1: `test ${i}`,
  })
})
await Promise.all(createTwoTest)

系统会返回一个请求被中止的错误，而另一个请求则成功执行。这与开发者预期的两个请求都能成功完成的情况不符。

根本原因

这个问题源于PocketBase JavaScript SDK的自动取消机制设计。该机制默认会取消同一用户的重复请求，以避免潜在的冲突或资源浪费。当管理员用户尝试同时发起多个创建请求时，SDK会认为这些是重复请求而自动取消部分请求。

解决方案

对于管理员用户需要执行批量创建操作的场景，最佳实践是禁用SDK的自动取消功能。可以通过以下方式实现：

// 创建管理员客户端实例时禁用自动取消
const adminPb = new PocketBase('http://127.0.0.1:8090', null, {
  autoCancel: false
})

这样配置后，管理员用户发起的并发请求将不再被自动取消，可以正常完成批量创建操作。

技术背景

PocketBase的并发控制机制主要考虑了两个层面：

1. 普通用户场景：默认启用自动取消，防止用户因快速重复操作导致的数据不一致或资源浪费。

2. 管理员场景：需要处理批量操作，因此建议禁用自动取消功能，确保所有操作都能按预期执行。

这种设计在保证系统稳定性的同时，也为特殊场景提供了灵活性。

最佳实践建议

1. 对于普通CRUD操作，保持自动取消功能启用
2. 仅在进行批量操作的管理员客户端中禁用自动取消
3. 批量操作完成后，考虑重新启用自动取消功能
4. 对于特别大量的批量操作，建议采用分批次处理而非一次性并发

通过理解这些机制，开发者可以更有效地利用PocketBase进行各类数据操作，避免不必要的错误和性能问题。