使用shareplum读取SharePoint列表正常，但无法添加列表项，求排查

针对你遇到的能读取但无法新增列表项的问题，从代码和SharePoint机制层面整理出以下问题点及解决方案：

1. 代码变量名不匹配 #

你定义了列表对象mylist = site.List(...)，但后续调用更新接口时用了未定义的incoming_list，这会直接触发变量未定义错误，需统一变量名。

2. 操作类型错误 #

新增列表项必须指定kind='New'，而你用了kind='Update'——这个参数是用来修改已有列表项的，完全不适用新增场景。

3. 字段名称需使用内部名称 #

SharePoint的字段显示名和内部名可能不一致（比如显示名是「项目字段」，内部名可能是Project_Field或ProjectField），你需要确保my_data里的字段名是列表字段的内部名称。
可以通过以下代码打印所有字段的内部名进行确认：

print(mylist.fields)

4. 站点URL路径不完整 #

你的site_url仅指向/sites根路径，需要补充具体的站点名称，比如https://mycompansharepointsite.org/sites/YourTeamSite，否则无法定位到目标站点的列表接口。

修正后的完整代码示例 #

from shareplum import Site
from requests_ntlm import HttpNtlmAuth

# 变量配置
username = "myusername"
password = "mypassword"
site_url = "https://mycompansharepointsite.org/sites/YourActualSite"  # 补全具体站点路径
domain = "myCompanyDomain"
my_list_name = "listTitle"
# 确保字段为内部名称，且包含所有必填字段
my_data = [{
    'Project_Field': 'TESTING'
}]

cred = HttpNtlmAuth(f'{domain}\\{username}', password)
site = Site(site_url, auth=cred)

mylist = site.List(my_list_name, exclude_hidden_fields=True)
# 使用kind='New'执行新增操作
response = mylist.UpdateListItems(data=my_data, kind='New')
# 打印响应查看执行结果（成功/失败的详细信息）
print(response)

额外排查步骤 #

• 检查账号权限：确保你的账号拥有该列表的编辑权限（仅读取权限无法新增）。
• 验证必填字段：如果列表存在必填字段，my_data必须包含所有必填字段的有效值，否则会新增失败。
• 查看响应详情：UpdateListItems返回的响应中会包含错误代码和描述，可根据提示进一步定位问题。

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