SPFX中FAQ更新遇400错误及TypeScript类型错误的原因咨询

之前项目中通过delete updateFAQ["odata.metadata"]解决过类似问题，但当前项目中该方法无效，且VSCode抛出TypeScript错误：

类型“IFAQ”上不存在属性“odata.metadata”，表达式“odata.metadata”用于索引时元素隐式具有“any”类型

当前项目的更新方法代码：

public async updateFAQ(updateFAQ: IFAQ): Promise<void> {
    delete updateFAQ["odata.metadata"] // VSCode报错
    await this._sp.web.lists.getById(this.faqListId).items.getById(updateFAQ.ID).update(updateFAQ);
}

控制台完整错误信息：

Uncaught (in promise) Error: Error making HttpClient request in queryable [400]  ::> {"odata.error":{"code":"-1, Microsoft.SharePoint.Client.InvalidClientQueryException","message":{"lang":"en-US","value":"A relative URI value 'Web/Lists(guid'e6197c8f-88c1-47c4-911e-538ee0638250')/Items(25)' was specified in the payload, but the odata.metadata annotation is missing from the payload. The payload must only contain absolute URIs or the odata.metadata annotation must be on the payload."}}} at HttpRequestError.init (parsers.js:96:1) at async Proxy.errorCheck (parsers.js:45:1) at async queryable.js:118:1

IFAQ接口定义：

export interface IFAQ {
    ID?: number;
    Question: string;
    Answer: string;
}

已实现的解决方案：将SP列表查询结果映射为仅包含IFAQ属性的对象，过滤元数据信息：

public async getFAQ(): Promise<IFAQ[]> {
    let result: IFAQ[] = await this._sp.web.lists.getById(this.faqListId).items();        

    let finalResult = result.map((x) => ({
        ID: x.ID,
        Question: x.Question,
        Answer: x.Answer
    }))
    
    return finalResult;
}

咨询问题 #

1. 为何delete updateFAQ["odata.metadata"]会抛出TypeScript错误？
2. 控制台400错误产生的原因是什么？

1. TypeScript错误原因 #

IFAQ接口中未定义odata.metadata属性，TypeScript作为强类型语言，会严格校验对象属性与接口定义的一致性。当你通过updateFAQ["odata.metadata"]访问接口不存在的属性时，TypeScript无法确定该属性的类型，因此抛出“元素隐式具有any类型”的错误。

之前项目中该方法可行，大概率是当时的接口允许任意属性（例如使用[key: string]: any），或是项目TypeScript配置未开启严格类型检查规则。

2. 控制台400错误原因 #

该错误由SharePoint的OData接口返回，核心原因是传入update方法的对象包含相对URI格式的OData元数据，但缺少必要的odata.metadata注解。

从SharePoint查询列表项时，返回结果会自带OData相关元数据属性（如odata.metadata、odata.type等）。若直接将原始查询结果传给update方法，SharePoint会尝试通过这些元数据定位资源，但你的请求要么缺失odata.metadata注解，要么元数据中的URI是相对路径，不符合接口要求，因此返回400错误。

你后续通过map过滤出纯业务属性的对象，相当于移除了所有OData元数据，传给update的是符合接口预期的纯数据，SharePoint无需解析元数据，错误自然消失。

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