快速答案与 Gemini 官方支持格式清单
在通过 Gemini 网页端进行多模态分析或文献研读时，如果文件上传进度条卡在 99% 或弹出红色错误感叹号，请首先核对文件 MIME 属性是否在官方白名单内：
| 文件大类 | 官方完全支持的扩展格式 | 不支持的格式 (需本地预转换) | 处理建议 |
|---|---|---|---|
| 文档与表格 | .pdf, .txt, .docx, .rtf, .csv, .xlsx, .tsv, .html | .doc (老旧Word97), .pages, .epub, .mobi, .caj | 另存为标准 PDF 或 TXT |
| 代码源码 | .py, .js, .ts, .html, .css, .json, .md, .cpp, .go, .java | 二进制编译产物 (.exe, .dll, .class, .pyc, .wasm) | 仅上传可读文本源码文件 |
| 图像格式 | .png, .jpg, .jpeg, .webp, .heic | .psd (Photoshop源文件), .ai, .raw 单反原片 | 导出为标准 PNG/JPG 图片 |
| 音频与视频 | .mp3, .wav, .m4a, .aac, .mp4, .mov, .webm | .mkv, .avi, .flv, .rmvb | 使用剪映或 HandBrake 转为 MP4 |
排查一：解密带有密码或安全打印限制的 PDF
许多银行账单、券商研报或学术期刊在导出时自带 Adobe 权限保护锁，云端沙箱在尝试解析其内部流时会抛出 EncryptionSecurityHandlerException 并直接中断：
- 在电脑上使用 Chrome 浏览器打开该 PDF。
- 按下键盘快捷键
Ctrl + P（Mac:Cmd + P）呼出系统打印对话框。 - 打印机目标选择 “另存为 PDF”（Save as PDF）。
- 点击保存为一个全新的纯净副本。
- 底层原理： 浏览器的虚拟打印管道会重新光栅化页面并物理剥离所有老旧的权限锁。
- 将新生成的 PDF 重新拖入 Gemini，即可秒级完成上传与长文本提炼（详见 Gemini 多模态研读指南）。
排查二：单文件过大导致浏览器 HTTP 连接超时
如果您尝试上传数百兆的超清 4K 视频或包含数千张超清插图的巨型 PDF：
- 压缩文档体积： 使用 Adobe Acrobat 或 ilovepdf 在线压缩工具将 PDF 从“印刷质量”压缩为“电子屏幕标准质量”。
- 视频转码压制： 使用 HandBrake 或剪辑软件将 4K 视频压缩为 720p H.264 格式（Gemini 模型分析视频时主要提取帧画面的语义空间特征，720p 的识别准确率与 4K 几乎 100% 一致，但文件体积缩减 90%，上传速度极速提升）。
排查三：使用 Google AI Studio 的 Files API 规避网页端不稳定
如果您是开发者或需要上传数 GB 的大规模数据集进行深度研究：
- 访问 Google AI Studio 控制台（aistudio.google.com）。
- 使用官方 Google GenAI SDK 提供的
genai.upload_file()端点。 - Files API 支持分块断点续传（Resumable Chunked Upload），并在 Google 云端服务器自动为大型文件生成长达 48 小时有效引用的 URI，调用速度与稳定性远超网页端。
常见错误与避坑指南
- 代码中硬编码了真实密钥： 如果上传的代码文件中包含了真实的 API Key 或 RSA 私钥明文，Google 安全审查网关会在前端静态扫描阶段直接拦截报错。
- 多文件并发超限： 单次对话建议同时上传不超过 5~10 个文件，以防超出浏览器 WebSocket 负载。
- 更多开发接口请参考 AI Studio API Key 开发者实战指南。
常见问题解答 (FAQ)
Q1：为什么上传的代码文件提示“包含敏感内容无法处理”？
如果代码中硬编码包含了带有真实格式的私钥（如 -----BEGIN RSA PRIVATE KEY-----）或密码明文，Google 的安全过滤网关会在上传前进行静态扫描并直接阻断，以保护用户隐私。
Q2：一次对话中最多支持同时上传多少个文件？
在 Gemini 网页端单次对话最多支持同时挂载 10 个 文件；在 Google AI Studio 中单次请求支持上传多达数十个文件，只要总 Token 消耗不突破 200 万上限即可。
Q3：Gemini 分析大文件时中途报错“An internal error has occurred”怎么回事？
这通常是由于网络代理在传输后半段发生抖动，导致 Gemini 服务端接收到的文件二进制流校验和（MD5 Checksum）不一致。重新上传即可恢复。
Q4：支持上传 ZIP 压缩包让 Gemini 自己解压分析吗？
目前网页端不支持直接解析 .zip 压缩包。请在本地解压后，全选内部的文本或代码文件直接批量拖拽上传。