Python-Websockets 14.0版本中extra_headers参数的重大变更解析

在Python-Websockets库从13.1版本升级到14.0版本的过程中，开发者需要注意一个重要的API变更：extra_headers参数的使用方式发生了改变。这个变更可能会影响到现有代码的正常运行，特别是那些需要添加自定义HTTP头部的WebSocket连接。

变更背景

在Python-Websockets 14.0之前的版本中，开发者可以通过extra_headers参数直接向WebSocket连接添加自定义HTTP头部。例如，添加认证令牌的典型代码如下：

extra_headers = {"Authorization": f"Bearer {auth_token}"}
async with websockets.connect(uri, extra_headers=extra_headers) as ws:
    # 连接处理代码

这种用法在13.1及更早版本中工作正常，但在14.0版本中会导致TypeError异常，提示BaseEventLoop.create_connection() got an unexpected keyword argument 'extra_headers'。

变更原因

这个变更是Python-Websockets库内部重构的一部分，目的是简化API并提高一致性。在14.0版本中，库对底层连接创建机制进行了调整，移除了直接传递extra_headers参数的支持。

解决方案

对于需要升级到14.0版本的开发者，应该使用新的additional_headers参数来替代原来的extra_headers。修改后的代码如下：

additional_headers = {"Authorization": f"Bearer {auth_token}"}
async with websockets.connect(uri, additional_headers=additional_headers) as ws:
    # 连接处理代码

这个变更不仅仅是参数名的简单替换，还反映了库内部处理HTTP头部方式的改进。新的additional_headers参数提供了更清晰、更一致的API设计。

升级建议

1. 在升级到Python-Websockets 14.0之前，检查项目中所有使用extra_headers参数的代码
2. 将extra_headers替换为additional_headers
3. 测试修改后的代码，确保所有自定义HTTP头部都能正确传递
4. 查看完整的变更日志，了解其他可能的API变化

这个变更虽然简单，但如果不注意可能会导致认证失败等连接问题。建议开发者在升级时特别注意这个API变化，确保WebSocket连接的稳定性和安全性。