使用Google Vision API读取GCS中JPG文件报错，求部署实现方法

一、解决gs://路径加载文件的"invalid arguments"错误 #

• 检查参数传递格式：调用Vision API时，不能直接把gs://字符串传给Image对象，必须通过ImageSource指定gcs_image_uri。示例代码：

from google.cloud import vision_v1

def detect_text_from_gcs(gcs_uri):
    client = vision_v1.ImageAnnotatorClient()
    # 正确构造Image对象
    image = vision_v1.Image(source=vision_v1.ImageSource(gcs_image_uri=gcs_uri))
    response = client.text_detection(image=image)
    return response.text_annotations

• 验证权限配置：运行代码的身份（本地开发用服务账号密钥，Cloud Functions用默认服务账号）必须拥有storage.objects.get权限，可在Cloud Storage控制台给对应账号添加Storage Object Viewer角色。
• 确认文件路径有效性：检查gs://路径的桶名、文件名是否正确，目标JPG文件确实存在于对应存储桶中。

二、Cloud Functions部署实现GCS图片自动OCR流程 #

1. 创建函数与触发器：
   • 在Cloud Functions控制台新建函数，触发器类型选Cloud Storage，事件类型选择最终创建/更新文件，指定要监听的存储桶。
   • 选择熟悉的运行环境（如Python 3.11），设置入口函数名称（比如process_gcs_image）。
2. 编写核心代码：

from google.cloud import vision_v1

def process_gcs_image(event, context):
    # 从触发器事件中获取文件信息
    file_info = event
    gcs_uri = f"gs://{file_info['bucket']}/{file_info['name']}"
    
    client = vision_v1.ImageAnnotatorClient()
    image = vision_v1.Image(source=vision_v1.ImageSource(gcs_image_uri=gcs_uri))
    response = client.text_detection(image=image)
    
    # 处理识别结果（示例：打印文本）
    if response.text_annotations:
        print(f"识别文本内容:\n{response.text_annotations[0].description}")
    else:
        print("未检测到任何文本")
    
    # 处理API错误
    if response.error.message:
        raise Exception(f"Vision API调用失败: {response.error.message}")

3. 配置依赖文件：在函数目录下创建requirements.txt，添加：

google-cloud-vision>=2.15.0

4. 部署与权限配置：
   • 部署时确保函数的服务账号拥有Vision API User和Storage Object Viewer角色，可在IAM控制台给函数的默认服务账号添加这两个角色。
   • 可通过Cloud控制台或gcloud functions deploy命令完成部署。

三、本地开发关键配置 #

• 本地运行代码前，必须设置环境变量指向服务账号密钥文件：

# Linux/macOS
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"

# Windows（PowerShell）
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your\service-account-key.json"

• 确保已在Google Cloud控制台启用Vision API。

内容的提问来源于stack exchange，提问作者april