Azure Cosmos DB插入数据时未自动生成'id'字段引发BadRequest报错

在Visual Studio Code中调试Python函数应用时，所有调用Azure Cosmos DB的写入操作均返回如下错误：
(BadRequest) Message: {"Errors":["One of the specified inputs is invalid"]}
相同代码在同事环境中可正常运行，无该报错。
最小复现代码：

item = { "firstname": "John", "lastname": "Doe"}
container.upsert_item(item)

已初步确认：报错直接诱因为插入条目缺失id字段，调用upsert_item前手动为item添加id字段即可正常执行。已尝试删除本地代码重新克隆仓库、卸载重装所有VS Code扩展、完全卸载重装Visual Studio Code，异常始终存在，说明相关配置未随上述操作被清除。
涉及的Cosmos DB容器属性如下，配置无异常：

Container properties {'id': 'person', 'indexingPolicy': {'indexingMode': 'consistent', 'automatic': True, 'includedPaths': [{'path': '/*'}], 'excludedPaths': [{'path': '/"_etag"/?'}]}, 'partitionKey': {'paths': ['/lastname'], 'kind': 'Hash'}, 'uniqueKeyPolicy': {'uniqueKeys': []}, 'conflictResolutionPolicy': {'mode': 'LastWriterWins', 'conflictResolutionPath': '/_ts', 'conflictResolutionProcedure': ''}, 'geospatialConfig': {'type': 'Geography'}, 'analyticalStorageTtl': -1, '_rid': 'O-pDAPQSY5Y=', '_ts': 1654191756, '_self': 'dbs/O-pDAA==/colls/O-pDAPQSY5Y=/', '_etag': '"00003b31-0000-0100-0000-6298f68c0000"', '_docs': 'docs/', '_sprocs': 'sprocs/', '_triggers': 'triggers/', '_udfs': 'udfs/', '_conflicts': 'conflicts/'}

待确认问题：为何此前本地环境、同事当前环境无需手动添加id字段即可正常插入数据，本地哪项配置变更导致SDK不再自动添加id字段？

该问题与Visual Studio Code、VS Code扩展配置无关，重装无效的核心原因是问题出在本地Python环境的Azure Cosmos DB SDK版本差异上：

• 4.3.0版本之前的azure-cosmos Python SDK，在调用create_item、upsert_item方法时，如果传入的条目缺失必填的id字段，SDK会自动生成UUID作为id值填充后再发送请求，因此不需要手动添加id也能正常写入。
• 从4.3.0版本开始，SDK移除了自动生成id的默认逻辑，会直接将原始条目发送给Cosmos DB服务端，服务端检测到id字段缺失就会返回上述BadRequest错误。
  你和同事的环境差异本质是SDK版本不一致：同事环境安装的是4.3.0之前的旧版SDK，你本地Python环境（项目虚拟环境/全局Python环境）安装的是4.3.0及以上的新版SDK，因此相同代码会出现不同表现。
  你之前尝试的重拉代码、重装VS Code、重装扩展都不会修改Python环境中已安装的依赖包版本——尤其是项目目录下被.gitignore忽略的虚拟环境目录（比如.venv、env），完全不会被上述操作影响，因此问题始终存在。

• 版本验证：分别在本地和同事使用的Python环境中执行pip show azure-cosmos，对比返回的Version字段即可确认版本差异。
• 修复方案二选一即可：
  • 推荐方案：代码层面主动为所有写入Cosmos DB的条目生成id字段，示例如下：

    import uuid
    item = { "firstname": "John", "lastname": "Doe"}
    item["id"] = str(uuid.uuid4())
    container.upsert_item(item)
    

    该写法不依赖SDK的隐式逻辑，所有SDK版本均可正常运行，兼容性最好。
  • 临时对齐方案：如果需要和同事环境行为完全一致，在本地对应Python环境中执行pip install azure-cosmos==4.2.0安装旧版本SDK即可，但不推荐长期使用旧版本，会错过后续安全补丁、bug修复和功能更新。

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