Lambda中使用urllib3调用API报无HTTPHeaderDict属性错误如何解决

错误原因 #

该AttributeError的触发原因是运行环境中的urllib3版本过低。HTTPHeaderDict 仅在urllib3 v1.26.0及以上版本中直接暴露在urllib3顶层命名空间，而AWS Lambda内置Python运行环境预装的urllib3通常为更低版本，未在顶层导出该类，因此调用urllib3.HTTPHeaderDict会触发属性不存在的错误。

排查步骤 #

• 临时在Lambda代码中添加urllib3版本打印逻辑，确认当前环境的版本号：

import urllib3
print(urllib3.__version__)

部署后查看CloudWatch日志输出，确认版本是否低于1.26.0。

解决方法 #

以下三个方案按需选择即可：

方案1：直接传入普通字典作为请求头（推荐，改动最小） #

urllib3的request方法本身支持直接传入普通Python字典作为headers参数，无特殊需求不需要特意构造HTTPHeaderDict，直接删除原有构造HTTPHeaderDict的代码即可，修改后示例如下：

import urllib3
import os
import json

# Get environment variable
api_url = os.getenv('API_URL')


def lambda_handler(event, context):
    request = json.loads(json.dumps(event))
    print(json.dumps(request['headers']))
    headers = request['headers']
    
    http = urllib3.PoolManager()
    # 直接传入普通字典即可，无需构造HTTPHeaderDict
    response = http.request('GET', api_url + '/', headers=headers, timeout=10)

    
    return {
        'statusCode': response.status,
        'headers': response.headers,
        'body': response.data
    }

方案2：从正确路径导入HTTPHeaderDict #

如果确实需要用到HTTPHeaderDict的重复键添加、大小写不敏感匹配等特殊功能，可以调整导入路径，低版本urllib3中该类存放在urllib3.util下：

# 替换原有 urllib3.HTTPHeaderDict 的用法
from urllib3.util import HTTPHeaderDict

更旧的版本可以从urllib3._collections导入：

from urllib3._collections import HTTPHeaderDict

方案3：打包高版本urllib3部署 #

如果需要使用高版本urllib3的其他特性，可以将v1.26.0及以上版本的urllib3和你的代码一起打包为Lambda层，或者直接打包到部署包中，覆盖内置的低版本urllib3即可。

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