本地部署Appwrite设无限用户上限仍触发超量错误的解决咨询

云上老周

2026-7-13

解决本地部署Appwrite无限用户上限不生效问题

问题描述

我为Flutter项目本地部署了Appwrite，已在控制台将项目用户上限设为无限，但执行用户注册、认证操作时仍收到错误：
The current project has exceeded the maximum number of users. Please check your user limit in the Appwrite console.

已确认控制台设置显示正确，当前使用的API端点：

static const endPoint = "http://localhost/v1";

控制台设置截图：

解决方案

重启Appwrite服务
修改用户上限配置后，必须重启服务才能生效。执行命令：
```
docker compose restart
```
单容器部署的话，直接重启对应容器即可。
核对项目ID一致性
确认Flutter代码里的项目ID和控制台中设置无限上限的项目ID完全匹配，避免选错项目导致配置不生效。
清理Appwrite缓存
缓存可能导致配置读取异常，进入Appwrite的数据目录（默认是./appwrite），删除cache文件夹内的所有文件，之后重启服务。
升级到最新稳定版
部分旧版本Appwrite存在无限用户上限的bug，执行以下命令升级：
```
docker compose pull
docker compose up -d
```
通过环境变量强制设置
如果控制台设置始终不生效，直接在docker-compose.yml的appwrite服务环境变量里添加：
```
- _APP_USERS_LIMIT=0
```
0代表无限制，保存后重启服务即可。