Google Generative AI Python SDK 文件上传功能异常分析与解决方案

近期Google Generative AI Python SDK（genai）用户报告了一个关键功能异常：upload_file方法上传文件时返回0字节且缺失MIME类型信息。该问题影响了包括generate_content在内的多个下游功能，导致基于文件输入的AI内容生成流程中断。

问题现象

当开发者使用genai.upload_file(path=path, mime_type=mime_type)方法上传文件时，返回的File对象存在以下异常特征：

• size_bytes始终显示为0
• mime_type字段为空字符串
• 虽然文件状态显示为"ACTIVE"，但实际无法用于后续处理

影响范围

该问题具有以下特点：

1. 跨平台性：不仅影响Python SDK，Node.js SDK用户也报告了相同问题
2. 全文件类型影响：PDF、视频(MP4)等多种文件类型均受影响
3. 时间特征：问题首次出现于2024年11月11日PDT时间中午前后

临时解决方案探索

在官方修复前，开发者尝试了多种临时解决方案：

1. Blob直接传输方案：

from google.generativeai import protos

with open(filepath, 'rb') as f:
    blob = protos.Blob(data=f.read(), mime_type=mime_type)
    response = model.generate_content([blob, prompt])

局限性：受20MB(20971520字节)的请求负载限制，不适合大文件

2. 文件分块传输尝试： 开发者尝试将大文件分块后分别创建Blob对象，但发现限制针对整个请求负载而非单个部分

问题根源与官方响应

经Google团队确认，该问题源于服务端的一次更新推送。核心故障点在于文件上传后的元数据处理环节出现异常，导致：

• 文件大小信息未能正确记录
• MIME类型信息丢失
• 虽然文件实际上传成功，但元数据不完整导致后续处理失败

Google团队于问题报告后约24小时内完成了热修复，服务现已恢复正常。

最佳实践建议

1. 版本控制：确保使用最新版SDK（当前为0.8.4+）
2. 异常处理：实现健壮的错误处理逻辑，特别是对400错误码的捕获
3. 监控机制：建议对关键API调用建立监控，及时发现类似服务端问题
4. 大文件策略：对于超过20MB的文件，必须使用upload_file方法而非直接传输

经验总结

此次事件凸显了AI服务集成中的几个关键点：

• 云端服务的变更可能随时影响客户端功能
• 需要为关键业务功能设计降级方案
• 官方状态页面的重要性（据团队反馈将建立）
• 开发者社区的快速响应价值

建议开发者在实现基于Gemini API的生产系统时，充分考虑服务中断的容错机制，并保持对官方通知渠道的关注。