部署Google Cloud Function遇Python AttributeError，本地运行正常求排查

部署Google Cloud Function时触发如下错误：

File "/layers/google.python.pip/pip/bin/functions-framework", line 8, in <module>
    sys.exit(_cli())
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/click/core.py", line 1130, in __call__
    return self.main(*args, **kwargs)
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/click/core.py", line 1055, in main
    rv = self.invoke(ctx)
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/click/core.py", line 1404, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/click/core.py", line 760, in invoke
    return __callback(*args, **kwargs)
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/functions_framework/_cli.py", line 37, in _cli
    app = create_app(target, source, signature_type)
  File "/layers/google.python.pip/pip/lib/python3.8/site-packages/functions_framework/__init__.py", line 288, in create_app
    spec.loader.exec_module(source_module)
  File "<frozen importlib._bootstrap_external>", line 843, in exec_module
  File "<frozen importlib._bootstrap>", line 219, in _call_with_frames_removed
  File "/workspace/main.py", line 18, in <module>
    bucket = client.get_bucket(const.destination_gcs_bucket)
AttributeError: module 'constants' has no attribute 'destination_gcs_bucket'

相关代码与配置：

• main.py 第17-18行：

client = storage.Client()
bucket = client.get_bucket(const.destination_gcs_bucket)

• requirements.txt 内容：

pandas
constants
google-cloud-storage
google-cloud-bigquery
lxml
flask
datetime

• constants.py 内容：

destination_gcs_bucket = 'nba_teams_data'

此前Cloud Function部署正常，仅修改了少量正则表达式业务逻辑后出现该问题。

• 修正模块导入冲突：你的requirements.txt中包含了第三方库constants，Python会优先导入这个已安装的第三方包，而非你本地的constants.py。解决方式二选一：
  1. 直接从requirements.txt中删除constants条目（你不需要这个第三方库，自定义的constants.py才是目标模块）；
  2. 将自定义的constants.py重命名为其他唯一名称（比如project_constants.py），同时同步修改main.py中的导入语句为import project_constants as const。
• 验证文件部署完整性：检查constants.py是否和main.py处于同一目录，确认部署时该文件被正确包含在上传包中。如果使用gcloud functions deploy命令，检查--source参数是否指定了正确的根目录，避免遗漏自定义模块文件。
• 本地环境复现测试：在本地通过functions-framework --target=<你的函数名称>启动测试，模拟Cloud Function运行环境，快速定位是导入逻辑问题还是部署时的文件缺失问题。

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