lix-2026
5f97800489
- wire SQLite control-plane access/session paths into Rust web local-folder routes - preserve local Markdown attachment semantics across upload, reload, and secondary-pane resource tabs - refresh design governance docs, Reasonix task templates, and bug records - retire root .mcp.json local MCP config
2.6 KiB
2.6 KiB
3-23 [done][bug] dev:hot 启动 inotify 限制导致 local-folder events 500 v1
发现时间：2026-05-23
状态：
[done]关联主线：
03-rust-web
1. 用户可见症状
执行：
npm run dev:hot
启动日志出现：
WARN System notification limit is too small, falling back to polling mode.
WARN Polling for changes every 500ms
ERROR response failed classification=Status code: 500 Internal Server Error latency=0 ms
mnote-web 本身能启动，但首屏随后会打一条 500。
2. 根因
浏览器网络请求定位到失败 endpoint：
GET /api/local-folder/events?rootUri=...
该请求返回的错误体为：
{
"code": "internal_error",
"message": "本地文件夹监听失败: OS file watch limit reached. about [\"/mnt/Data1T/Mnote_data/users/mnote-e2e/workspaces/my-space\"]"
}
因此根因不是 route 业务逻辑回归，而是 Linux inotify watcher 容量不足：
cargo watch在启动时检测到系统通知额度不足，降级为 polling。mnote-web首屏建立本地工作区 SSE watcher 时也申请 watcher。- 当前用户已有 watcher 占用接近系统上限，导致
/api/local-folder/events创建监听失败并返回 500。
3. 修复
已在系统层即时提高并持久化 inotify 容量：
sudo sysctl fs.inotify.max_user_watches=1048576 fs.inotify.max_user_instances=1024 fs.inotify.max_queued_events=32768
持久配置写入：
/etc/sysctl.d/99-mnote-dev.conf
内容：
fs.inotify.max_user_watches=1048576
fs.inotify.max_user_instances=1024
fs.inotify.max_queued_events=32768
4. 验证
验证系统参数：
sysctl fs.inotify.max_user_watches fs.inotify.max_user_instances fs.inotify.max_queued_events
结果：
fs.inotify.max_user_watches = 1048576
fs.inotify.max_user_instances = 1024
fs.inotify.max_queued_events = 32768
验证 SSE：
/api/local-folder/events?... 返回 200，并收到 ready 事件。
验证启动：
FRONTEND_PORT=3107 timeout 10s npm run dev:hot
结果：无 System notification limit warning，无启动期 500。
重新启动真实入口：
npm run dev:hot
结果：http://localhost:3000 正常启动；浏览器首屏网络请求中 /api/local-folder/events?... 为 200。
5. 剩余边界
这是系统资源配置问题，本仓库代码不需要为本次 inotify 限制做业务改动。若后续再次出现同类 500，应先统计当前 inotify watcher 占用和后台进程，再判断是继续提高系统额度还是清理异常 watcher 进程。