Gemini Notebook接入API后OOM需同步排查客户端泄漏、请求体膨胀与虚拟内存配置：一、确认错误日志含OutOfMemoryError等而非429；二、定位notebook主进程或SDK线程内存占用；三、禁用历史缓存、截断长文本、卸载JVM代理；四、调大JVM堆与Metaspace、迁移pagefile至NVMe、禁用DiagTrack；五、精准清理各系统GeminiNotebook专属缓存目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
GeminiNotebook接入API后频繁弹出“MemoryLimitExceeded”或系统级OOM报错，进程直接被kill，不是模型响应慢或超时，而是JVM/Python进程因内存持续攀升触达硬性限制——此时必须同步排查客户端内存泄漏、请求体膨胀与虚拟内存配置三重问题。
确认是否真为内存溢出而非API限流
第一步：检查错误日志中是否含java.lang.OutOfMemoryError、MemoryLimitExceededException或Python的MemoryError；若出现429 Too Many Requests或Retry-After头，则属于配额问题，应跳转至速率限制排查路径。【切勿将429误判为内存溢出，二者修复路径完全相反】
第二步：在GeminiNotebook运行环境中执行ps aux --sort=-%mem | head -10（Linux/macOS）或打开任务管理器→详细信息→按“内存”降序排列（Windows），确认是notebook主进程（如jupyter-notebook、python、java）还是gemini-client SDK线程独占内存。
阻断客户端内存泄漏链
方法一：禁用GeminiNotebook自动缓存对话历史功能
默认情况下，GeminiNotebook会将每轮contents完整序列持久化到本地内存缓存池。若连续调用超50轮且未手动清空chat_history，缓存对象引用不释放，GC无法回收。在初始化client时显式关闭：client = GeminiClient(enable_history_cache=False)。
方法二：强制切割长文本请求体
发送含10万字PDF解析结果的text字段时，SDK内部会将其转为UTF-8字节数组+Base64编码缓冲区，单次请求可瞬时申请1.2GB堆内存。必须在调用前用text[:8192]截断或启用流式分块：for chunk in split_by_token(text, max_tokens=2048): client.send(chunk)。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
方法三：卸载冲突的JVM代理工具
部分用户为调试API启用了Byte Buddy或Java Agent类热替换工具，这些工具会在每次请求时注入字节码并驻留Classloader，导致Metaspace持续增长。执行java -XX:+PrintGCDetails -version，若日志中反复出现Metaspace GC但内存不降，立即移除-javaagent:参数。
重设虚拟内存与进程资源上限
① 将GeminiNotebook启动脚本中的JVM堆上限从-Xmx2g改为-Xmx4g -XX:MaxMetaspaceSize=512m；若使用Python环境，在~/.jupyter/jupyter_notebook_config.py中添加：c.NotebookApp.max_buffer_size = 1073741824（1GB）。
② 手动迁移pagefile.sys至NVMe SSD：
Win+R → sysdm.cpl → 高级 → 性能→设置→高级→虚拟内存→更改 → 取消勾选“自动管理”，选择NVMe盘符 → 自定义大小：初始值=物理内存×1.5，最大值=物理内存×2.5 → 设置 → 确定 → 重启生效。
③ 关闭Windows遥测服务DiagTrack与dmwappushservice，防止其后台日志缓存与GeminiNotebook争抢内存页——这两项服务在高负载下会触发隐蔽内存分配，加剧OOM概率。
清理GeminiNotebook专属缓存目录
这一步必须精准定位，不能只删浏览器缓存：
Windows路径：%LOCALAPPDATA%\Programs\GeminiNotebook\Cache
macOS路径：~/Library/Caches/com.google.gemini-notebook
Linux路径：~/.cache/gemini-notebook
删除整个Cache文件夹后，重启GeminiNotebook——旧缓存中损坏的protobuf序列化对象常引发GC失败，是内存持续泄漏的隐性源头。
