退出终端后树莓派Ubuntu Server蓝牙连接失败问题求助

根本原因 #

Ubuntu Server 下，蓝牙音频的 A2DP 等 profile 依赖用户会话级的音频服务（Pulseaudio/PipeWire），终端登出后用户会话结束，音频服务随之停止，导致 bluetoothd（系统级蓝牙服务）无法加载音频协议，进而连接失败。虽然 bluetoothd 本身是系统服务，但音频功能的支撑需要用户级/系统级的音频会话配合。

具体解决步骤 #

1. 配置系统级音频服务（PipeWire/Pulseaudio） #

Ubuntu Server 22.04+ 默认使用 PipeWire，先确认当前音频服务类型：

pw-cli info  # 输出含PipeWire则为PipeWire；否则用pactl info检查Pulseaudio

针对 PipeWire：

• 启用系统级 PipeWire 及 Pulse 兼容服务：

  sudo systemctl enable --now pipewire.service pipewire-pulse.service
  

• 编辑蓝牙监控配置，允许系统级访问：

  sudo nano /etc/pipewire/media-session.d/bluez-monitor.conf
  

  确保以下配置项存在并正确：

  bluez5.enable = true
  bluez5.system-role = "auto"
  

• 重启 PipeWire 服务：

  sudo systemctl restart pipewire.service pipewire-pulse.service
  

针对 Pulseaudio：

• 修改系统级 Pulse 配置，加载蓝牙发现模块：

  sudo nano /etc/pulse/system.pa
  

  确保添加/启用该行：

  load-module module-bluetooth-discover
  

• 启用并启动系统级 Pulseaudio 服务：

  sudo systemctl enable --now pulseaudio.service
  

2. 优化蓝牙服务配置 #

• 编辑 /etc/bluetooth/main.conf：

  sudo nano /etc/bluetooth/main.conf
  

  确认以下关键配置：

  AutoEnable=true          # 自动启用蓝牙控制器
  ControllerMode=bredr     # 针对经典蓝牙音箱（若为BLE设备可设成dual）
  

• 重启蓝牙服务：

  sudo systemctl restart bluetooth
  

3. 调整脚本执行环境 #

• 使用系统级 crontab（而非用户 crontab）执行脚本，确保运行在系统会话中：

  sudo crontab -e
  

  添加定时任务（7:30 执行）：

  30 7 * * * /usr/bin/python3 /path/to/your/script.py >> /var/log/bluetooth_audio.log 2>&1
  

• 修改脚本，指定蓝牙设备及系统级音频输出：

  import os
  import subprocess
  
  # 设置系统级音频环境变量
  os.environ["XDG_RUNTIME_DIR"] = "/run/user/0"
  os.environ["PULSE_RUNTIME_PATH"] = "/run/pulse"
  
  # 蓝牙设备MAC地址
  DEVICE_MAC = "XX:XX:XX:XX:XX:XX"
  
  # 连接蓝牙音箱
  subprocess.run(
      ["bluetoothctl", "connect", DEVICE_MAC],
      check=True,
      stdout=subprocess.PIPE,
      stderr=subprocess.PIPE,
      text=True
  )
  
  # 指定蓝牙输出设备播放音频
  subprocess.run(
      ["mpg123", "-a", f"bluez_sink.{DEVICE_MAC.replace(':', '_')}.a2dp_sink", "/path/to/audio.mp3"],
      check=True,
      stdout=subprocess.PIPE,
      stderr=subprocess.PIPE,
      text=True
  )
  

4. 验证配置有效性 #

• 登出所有用户终端，执行以下命令检查蓝牙 profile 状态：

  sudo bluetoothctl show
  

  确认输出的 UUIDs 中包含 0000110b-0000-1000-8000-00805f9b34fb（A2DP Sink 的标准 UUID），说明音频服务已成功加载协议。

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