pigpio 库本身不提供直接的连接超时参数，但可通过检查 pi.connected 属性快速判断连接状态，结合 socket 层手动设置超时，可有效避免默认长达 30 秒的阻塞等待。
pigpio 库本身不提供直接的连接超时参数，但可通过检查 `pi.connected` 属性快速判断连接状态，结合 socket 层手动设置超时，可有效避免默认长达 30 秒的阻塞等待。
在使用 pigpio.pi(host, port) 远程连接 Raspberry Pi 时，底层 TCP 连接由系统默认 socket 行为控制——若目标主机不可达或 pigpiod 未运行，pigpio.pi() 构造函数不会抛出异常，而是立即返回一个 pigpio.pi 实例（即使连接失败），仅在后续首次调用 GPIO 方法时触发延迟报错。其默认连接超时不可配置，首试约 30 秒，重试约 3 秒，严重影响程序响应性。
幸运的是，pigpio 提供了可靠的连接状态检查机制：pi.connected 是一个只读布尔属性，在实例创建后即可立即访问，无需任何 I/O 操作。它准确反映底层 socket 是否已成功建立并完成 pigpio 协议握手：
import pigpio
pi = pigpio.pi('192.168.108.1', 8888)
if not pi.connected:
print("❌ 连接失败：无法访问 pigpiod 服务")
# 可在此处清理资源或退出
exit(1)
print("✅ 连接成功，可安全执行 GPIO 操作")⚠️ 注意：pi.connected 的值在构造后即确定，不会因后续网络中断而自动更新；它仅表示初始连接是否成功。若需持续保活，应配合 socket.SO_KEEPALIVE（如原代码所示）及应用层心跳检测。
若需更精细的超时控制（例如 5 秒内强制放弃），推荐在创建 pigpio.pi 前，预检 TCP 端口连通性：
import socket
import pigpio
def connect_with_timeout(host, port, timeout=5):
# 预检：尝试建立 TCP 连接（非 pigpio 协议）
try:
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.settimeout(timeout)
sock.connect((host, port))
sock.close()
except (socket.timeout, ConnectionRefusedError, OSError) as e:
print(f"? TCP 连接预检失败（{timeout}s 超时）: {e}")
return None
# 此时再初始化 pigpio（大概率成功）
pi = pigpio.pi(host, port)
if not pi.connected:
print("⚠️ pigpio 协议握手失败（可能 daemon 版本不兼容或认证问题）")
return None
return pi
# 使用示例
pi = connect_with_timeout('192.168.108.1', 8888, timeout=3)
if pi is None:
raise RuntimeError("Raspberry Pi 连接超时，终止初始化")✅ 总结：
- 首选方案：始终检查 pi.connected —— 简单、可靠、零额外开销；
- 进阶方案：TCP 预检 + pi.connected 双重验证，实现精确超时控制；
- 避免误区：不要依赖 pigpio.pi() 是否抛异常来判断连接状态（它几乎不抛异常）；
- 生产建议：在关键应用中，将连接逻辑封装为带重试与退避策略的函数，并记录详细错误上下文以便调试。
