Google Cloud Function连接BigQuery报无Client属性错误

报错信息 #

函数调用返回错误：

错误：函数已终止。建议操作：检查日志确认终止原因，更多故障排查可参考官方函数日志排查相关文档。详情：500 Internal Server Error：服务器遭遇内部错误无法完成请求，可能原因为服务器过载或应用程序存在错误。

运行日志定位到核心错误栈：

Traceback (most recent call last):
File "/layers/google.python.pip/pip/lib/python3.9/site-packages/flask/app.py", line 2073, in wsgi_app response = self.full_dispatch_request()
File "/layers/google.python.pip/pip/lib/python3.9/site-packages/flask/app.py", line 1518, in full_dispatch_request rv = self.handle_user_exception(e)
File "/layers/google.python.pip/pip/lib/python3.9/site-packages/flask/app.py", line 1516, in full_dispatch_request rv = self.dispatch_request()
File "/layers/google.python.pip/pip/lib/python3.9/site-packages/flask/app.py", line 1502, in dispatch_request return self.ensure_sync(self.view_functions[rule.endpoint])(**req.view_args)
File "/layers/google.python.pip/pip/lib/python3.9/site-packages/functions_framework/init.py", line 99, in view_func return function(request._get_current_object())
File "/workspace/main.py", line 72, in entry client = bigquery.Client()
AttributeError: 'function' object has no attribute 'Client'

现有配置 #

测试入口函数代码：

import os
import json
from google.cloud import bigquery

def entry(request):
    client = bigquery.Client()
    query_job = client.query("""SELECT MAX(day) FROM `name of project and bigquery table`""")
    for i in query_job:
        print(i[0])
    return "ok"

依赖配置requirements.txt：

google-cloud-bigquery
sqlalchemy==1.4.37
pandas==1.4.2
PyMySQL==1.0.2

根因判断 #

报错明确指向bigquery在执行到bigquery.Client()时是函数对象，而非导入的BigQuery客户端模块——你贴出的精简代码仅10行左右，但报错位置在main.py第72行，说明实际运行的代码中，from google.cloud import bigquery导入语句之后，存在同名的bigquery自定义函数或变量赋值，覆盖了导入的模块引用，导致调用Client属性时找不到对应方法。

可行排查与修复方案 #

• 全局检索main.py文件内所有bigquery标识符，定位导入语句之后定义的同名函数、同名变量，这类重名定义会直接覆盖模块引用，是触发本次错误的核心原因。
• 如果业务逻辑需要保留名为bigquery的自定义函数/变量，直接给导入的BigQuery模块起别名规避冲突即可，修改导入语句为from google.cloud import bigquery as bq，后续初始化客户端的代码同步修改为client = bq.Client()。
• 修复命名问题后，确认Cloud Function绑定的运行时服务账号，拥有目标BigQuery数据集、表的对应查询权限，避免后续出现鉴权类报错。
• 部署前在本地Python3.9环境下执行pip install -r requirements.txt，确认依赖安装无版本冲突，google-cloud-bigquery无需锁死过低版本，兼容Python3.9运行时即可正常使用。

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