如何修复Python IndexError: list index out of range索引越界报错

错误核心 #

触发报错的代码行为：

percent = soup.find('tbody').find_all('tr')[a].find('td').find_all(class_ ='styled__PercentContainer-sc-1qtnlbe-0 eeuaGk')

IndexError: list index out of range
该错误的本质是链式调用过程中，某一步find_all()返回的节点列表长度小于你要访问的索引值a，代码预期的DOM结构和实际拿到的页面源码结构不一致。

排查思路 #

按从上游到下游的顺序逐层校验，不要直接写长链式调用：

• 先校验最上游的tbody节点是否存在：打印soup.find('tbody')的返回值，如果返回None，说明你拿到的页面源码里根本没有目标表格。常见原因是请求被反爬拦截返回了异常页面、或者表格内容是JS动态渲染的，静态请求拿到的源码不包含这部分DOM。
• 再校验tr节点的实际数量：单独提取tr列表，打印列表长度和你使用的索引a的取值范围。常见踩坑点：表格包含表头行占了位置、页面分页只返回了部分行数据、循环计数从1开始而列表索引从0开始，最终导致a大于等于tr列表的最大有效索引。
• 最后校验目标class的有效性：你匹配的class是CSS Modules编译生成的类名，其中eeuaGk是随机哈希后缀，不同访问时间、不同页面版本下这个后缀可能变化，就算索引不越界，后续按完整双类名匹配也大概率拿不到目标节点。

修复方案 #

• 给所有DOM查询加存在性校验，禁止无判断直接按下标取节点：

# 逐层拆分链式调用，每一步做校验
tbody = soup.find('tbody')
if not tbody:
    raise RuntimeError("未找到目标表格，请检查请求是否正常返回、页面是否需要动态渲染")

tr_list = tbody.find_all('tr')
if a >= len(tr_list):
    print(f"索引越界，当前页面共加载{len(tr_list)}行表格数据，待访问索引为{a}")
    # 此处可加调试逻辑，比如打印当前页面源码确认内容加载情况
    exit()
target_tr = tr_list[a]

• 优化class匹配规则，不要依赖易变的随机后缀：用CSS属性选择器匹配稳定的类名前缀即可，替换原有的find_all写法：

# 匹配class以固定前缀开头的节点，忽略后面随机生成的哈希部分
percent_nodes = target_tr.select_one('td [class^="styled__PercentContainer-sc-1qtnlbe-0"]')

• 如果排查确认是动态渲染导致源码缺失目标节点，替换静态请求方案，用可执行JS的工具（如playwright、selenium）拿到页面完全渲染后的源码，再交给BeautifulSoup解析。

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