Google Generative AI Python SDK文件上传问题分析与解决方案

问题概述

Google Generative AI Python SDK近期出现了一个严重的文件上传功能异常。具体表现为当开发者使用genai.upload_file()方法上传文件时，返回的文件对象中size_bytes始终显示为0，mime_type字段为空字符串。这个问题影响了所有依赖文件上传功能的下游操作，包括generate_content方法。

问题现象

开发者反馈的主要异常表现包括：

1. 上传的文件对象中size_bytes属性总是返回0
2. mime_type属性总是返回空字符串
3. 尝试使用这些上传的文件进行内容生成时，会收到400错误响应
4. 错误信息提示"Unable to submit request because it has an empty mimeType parameter in fileData"

影响范围

这个问题不仅影响了Python SDK，Node.js SDK也报告了相同的问题。从开发者反馈来看，问题大约开始于2024年11月11日中午(PDT时间)，似乎是服务端的一次更新导致的。

临时解决方案

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

1. 使用Blob直接传递文件内容：

from google.generativeai import protos

with open(filepath, 'rb') as fp:
    file_contents = fp.read()
    media_blob = protos.Blob(data=file_contents, mime_type=mime_type)
    response = model.generate_content([media_blob, prompt_text])

2. 限制文件大小： Blob方案仅适用于小于20MB的文件，因为API有20971520字节(20MB)的请求负载限制。

问题根源分析

从开发者反馈和错误信息来看，问题可能出在服务端的文件上传处理逻辑上。上传的文件虽然被接收并创建了文件记录，但关键的元数据(文件大小和MIME类型)没有被正确设置和返回。

官方响应与修复

Google团队确认了这个问题并进行了修复。根据官方回复，他们已经部署了修复方案，并计划建立状态页面以便开发者更好地跟踪此类问题。

最佳实践建议

1. 对于大文件处理，始终使用upload_file方法而非直接传递Blob
2. 在生产环境中实现适当的错误处理和重试机制
3. 考虑在客户端验证文件大小和类型，避免不必要的上传尝试
4. 关注官方更新，及时升级SDK版本

总结

这次事件凸显了API服务稳定性对开发者工作流的重要性。虽然问题已经解决，但它提醒我们在依赖云服务时需要考虑容错机制和备用方案。Google团队快速响应并解决问题的态度值得肯定，未来建立状态页面的计划也将有助于提高服务透明度。