树莓派显示所有I2C连接时报error 引脚连接异常求解

报错截图参考：

先排查软件配置问题 #

硬件排查前先确认基础配置，避免无效操作：

• 终端执行sudo raspi-config，进入Interface Options > I2C选项，确认I2C硬件接口处于启用状态，保存配置后重启树莓派再重试扫描。
• 核对I2C总线编号：初代树莓派1 Model B默认对外I2C总线号为0，其余所有量产型号（2/3/4/5代、Zero全系列）默认硬件I2C总线号为1，扫描命令需匹配对应总线号，例如1号总线扫描命令为i2cdetect -y 1，输错总线号会直接触发无设备报错。

引脚连接问题排查（核心故障源） #

所有接线操作必须在树莓派完全断电状态下操作，GPIO不支持热插拔，带电接线大概率烧毁引脚或外设：

• 核对引脚定义：树莓派默认硬件I2C引脚为物理3号针（SDA，数据线）、物理5号针（SCL，时钟线），外设侧SDA、SCL必须和树莓派侧一一对应，两根信号线接反会直接导致通信失败。
• 确认供电与共地：外设VCC引脚接对应额定电压（90%以上常用I2C传感器工作电压为3.3V，不要随意接5V引脚，避免直接烧毁器件），外设GND必须和树莓派的物理GND针直连，共地缺失是I2C故障最高发的隐性原因，很多人接线只接SDA/SCL/VCC忘了共地，反复调试都无法通信。
• 检查总线上拉：I2C协议要求SDA、SCL线各接一个4.7kΩ左右的上拉电阻到3.3V，绝大多数成品传感器模块自带板载上拉，如果用的是裸I2C芯片，必须自行补焊上拉电阻，否则总线电平无法正常拉高，会持续报通信错误。

故障定位与兜底解决 #

• 接线确认无误后上电，重新执行I2C扫描命令，正常情况下输出的网格里会直接显示扫描到的设备十六进制地址。
• 依然报错的话，先把所有外接I2C设备全拔掉，空总线运行扫描命令：
  • 空总线状态下还是报错，基本是树莓派原生I2C引脚被烧毁，直接用软I2C映射其他GPIO即可：编辑/boot/config.txt，在文件末尾加一行配置dtoverlay=i2c-gpio,bus=4,i2c_gpio_sda=17,i2c_gpio_scl=27，重启后执行i2cdetect -y 4，就能用物理11号针（GPIO17）、13号针（GPIO27）作为新的I2C总线，无需更换硬件。
  • 空总线扫描正常的话，每次只接一个I2C设备上电测试，很快就能定位到接线错误或者本身硬件损坏的外设。

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