Python请求响应迭代时的Typecheck Errors含义解析求助

问题背景代码 #

send_request函数 #

self.query = {"cql": f"type=page and label='{label}'"}

self.response = requests.request(
    "GET",
    self.rest_url,
    auth=BearerAuth(self._token),
    params=self.query,
    timeout=100,
)

return self.response.json()

get_page_details函数 #

def get_page_details(self) -> dict:
    """Iterate through JSON response to get necessary page details."""

    for label in labels:
        self.json_response = self.send_request(label)
        results_list=self.json_response.get("results")
        
        # Get page ids from JSON result
        page_ids = []
        for i in range(0, len(results_list)):
            page_ids.append(results_list[i]["content"]["id"])

        if page_ids:
            self.page_details[label] = page_ids

        else:
            continue

    return self.page_details

类型检查报错信息 #

error1: Argument 1 to "len" has incompatible type "Optional[Any]"; expected "Sized" [arg-type]
对应代码行：for i in range(0, len(results_list)):

error2: Value of type "Optional[Any]" is not indexable [index]
对应代码行：page_ids.append(results_list[i]["content"]["id"])

报错原因解析 #

error1 解释 #

results_list = self.json_response.get("results") 使用字典的get()方法时，如果响应JSON里不存在"results"这个键，方法会返回None。类型检查工具（如mypy）识别到results_list的类型是Optional[Any]——它既可能是可计算长度的列表，也可能是None。而len()函数要求参数必须是可计算长度的类型（Sized），None不满足这个要求，因此触发报错。

error2 解释 #

同样因为results_list可能为None，而None是无法通过下标（如results_list[i]）访问元素的，类型检查工具预见到这种潜在的运行时错误，所以提示“Optional类型不可索引”。

修复方案 #

通过确保results_list不会为None，同时优化遍历逻辑来解决问题：

def get_page_details(self) -> dict:
    """Iterate through JSON response to get necessary page details."""

    for label in labels:
        self.json_response = self.send_request(label)
        # 给get方法设置默认值为空列表，避免返回None
        results_list = self.json_response.get("results", [])
        
        # 用列表推导式直接遍历，同时添加键存在检查避免KeyError
        page_ids = [
            item["content"]["id"] 
            for item in results_list 
            if "content" in item and "id" in item["content"]
        ]

        if page_ids:
            self.page_details[label] = page_ids

    return self.page_details

修复要点 #

1. 给get()方法设置默认值[]：即使响应中没有"results"键，results_list也会是空列表，从根源消除Optional类型问题。
2. 使用列表推导式代替索引遍历：代码更简洁，同时避免手动索引带来的冗余和潜在错误。
3. 添加键存在检查：防止响应JSON中缺失content或id字段导致的KeyError。

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