从Node.js连接SharePoint API时遇到身份验证问题

针对你用spauth连接SharePoint API时遇到的身份验证问题，直接给你列几个必查点和修复方案：

常见问题与修复 #

1. ADFS URL 不完整 #

你写的adfsUrl: 'https://adfs3'是无效的，spauth需要完整的ADFS用户名密码认证端点，通常格式是：
https://adfs3.yourdomain.com/adfs/services/trust/13/usernamemixed
必须补全域名和具体的认证路径，否则无法正确发起ADFS请求。

2. 变量重赋值语法错误 #

你用const声明了headers，之后又直接headers = {...headers, ...}，这会触发语法错误——const变量不能被重新赋值。改成用let声明，或者直接生成新的headers对象：

// 正确写法1：用let声明
let headers = await spauth.getAuth(url, {
  username: "xyz@yourdomain.com", // 注意UPN格式
  password: "xyz",
  relyingParty: 'urn:sharepoint:portal',
  adfsUrl: 'https://adfs3.yourdomain.com/adfs/services/trust/13/usernamemixed'
});
headers = {
  ...headers,
  Accept: 'application/json;odata=verbose'
};

// 正确写法2：直接生成新对象
const authHeaders = await spauth.getAuth(url, { /* 配置项 */ });
const finalHeaders = {
  ...authHeaders,
  Accept: 'application/json;odata=verbose'
};

3. 用户名格式不正确 #

ADFS认证要求用户名是完整的UPN格式（比如xyz@yourdomain.com），而不是单纯的短用户名xyz，这是最容易踩的坑之一。

4. 依赖方标识符不匹配 #

确认ADFS服务器中配置的SharePoint依赖方信任的标识符，和你代码里的relyingParty: 'urn:sharepoint:portal'完全一致——大小写、拼写、特殊字符都不能错，否则ADFS会拒绝认证请求。

额外排查步骤 #

• 测试ADFS端点是否可访问：用curl或Postman直接请求你补全后的ADFS URL，确认网络连通性。
• 检查账号权限：确保你用的账号有访问目标SharePoint站点的权限，并且ADFS允许该账号通过用户名密码认证。

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