树莓派安装OpenCV失败求助：404 Not Found加速器错误

一、修复APT 404错误（根源问题） #

APT出现404错误大多是软件源地址失效或系统版本过旧导致，按以下步骤处理：

1. 备份现有源文件

   sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
   sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.bak
   

2. 确认系统版本代号
   执行命令查看你的树莓派系统版本（如bullseye、bookworm）：

   cat /etc/os-release | grep VERSION_CODENAME
   

3. 替换为可用软件源
   根据系统版本替换源文件内容：

   • 编辑主源文件：

     sudo nano /etc/apt/sources.list
     

     将原有内容替换为清华源（以bullseye为例，其他版本替换对应代号）：

     deb http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bullseye main non-free contrib rpi
     deb-src http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bullseye main non-free contrib rpi
     

     按Ctrl+O保存，Ctrl+X退出。

   • 编辑树莓派专属源文件：

     sudo nano /etc/apt/sources.list.d/raspi.list
     

     替换为：

     deb http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bullseye main ui
     

     保存退出。

   • 若使用已停止支持的旧版本（如stretch），需改用归档源：
     主源文件替换为：

     deb http://archive.raspbian.org/raspbian/ stretch main non-free contrib rpi
     deb-src http://archive.raspbian.org/raspbian/ stretch main non-free contrib rpi
     

     树莓派源文件替换为：

     deb http://archive.raspberrypi.org/debian/ stretch main ui
     

4. 更新源并验证
   执行命令更新源列表，确认无404错误：

   sudo apt update
   

   再执行系统升级：

   sudo apt upgrade -y
   

二、重新安装OpenCV #

修复APT问题后，可选择以下方式安装：

方式1：通过APT安装（系统集成版） #

sudo apt install python3-opencv libopencv-dev -y

注意：树莓派新系统默认用Python3，python-opencv是Python2的包，建议安装python3-opencv。

方式2：通过PIP安装（最新版本） #

直接pip install opencv是错误的，需指定正确包名：

# 基础功能版本
pip3 install opencv-python
# 包含额外功能模块（如特征检测、跟踪）的版本
pip3 install opencv-contrib-python

如果安装速度慢，可使用国内PIP源加速：

pip3 install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple

验证安装成功 #

打开Python3终端，执行以下命令：

import cv2
print(cv2.__version__)

若输出OpenCV版本号，则安装成功。

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