Ubuntu 20.04树莓派中pactl命令在关联systemd服务的Python脚本中执行失败的问题排查

从你提供的日志来看，pactl命令返回码1失败，结合你怀疑的运行身份/环境变量问题，这大概率是因为systemd服务运行时缺少PulseAudio所需的用户会话上下文，下面一步步帮你排查和解决：

一、先确认问题根源 #

首先手动验证指定用户身份下pactl是否能正常工作：

su - 你的用户名 -c "pactl set-sink-mute alsa_output.platform-bcm2835_audio.stereo-fallback.2 1"

如果这个命令能正常执行，说明用户本身的权限没问题，问题出在systemd服务的环境变量或启动时机上；如果执行失败，那需要先检查该用户的PulseAudio配置是否正常。

二、修正systemd服务配置 #

systemd服务默认的环境变量集非常有限，而PulseAudio依赖XDG_RUNTIME_DIR等变量来找到用户的音频会话。修改你的服务文件（比如/etc/systemd/system/motion-sensor.service）：

[Unit]
Description=PIR传感器控制显示器与音频
After=graphical.target pulseaudio.service

[Service]
User=你的用户名
Group=你的用户名
# 明确指定PulseAudio需要的环境变量
Environment="XDG_RUNTIME_DIR=/run/user/$(id -u 你的用户名)"
Environment="DISPLAY=:0"
# 设置脚本的工作目录，确保能读取default_sink.txt
WorkingDirectory=/path/to/你的脚本所在目录
ExecStart=/usr/bin/python3 /path/to/你的脚本.py
Restart=on-failure
Type=simple

[Install]
WantedBy=graphical.target

关键配置说明：

• After=graphical.target pulseaudio.service：确保服务在桌面会话和PulseAudio完全启动后再运行，避免过早执行pactl
• XDG_RUNTIME_DIR：每个用户的PulseAudio socket都在这个目录下（格式为/run/user/用户UID），必须明确指定
• WorkingDirectory：避免脚本找不到default_sink.txt的问题

三、优化Python脚本中的pactl调用 #

在脚本中显式设置必要的环境变量，同时捕获错误输出方便排查：

import os
import time
from datetime import datetime
from gpiozero import MotionSensor
import logging
import subprocess

# 配置日志
logging.basicConfig(filename='motion.log', level=logging.INFO)

# 显式设置环境变量
uid = os.getuid()
os.environ['XDG_RUNTIME_DIR'] = f'/run/user/{uid}'
os.environ['DISPLAY'] = ':0'
os.environ['PATH'] += ':/usr/bin'

# 读取默认sink
try:
    with open('default_sink.txt', 'r') as f:
        default_sink = f.read().strip()
except FileNotFoundError:
    logging.error("找不到default_sink.txt文件，请检查脚本工作目录")
    exit(1)

# 检查PulseAudio是否运行
def check_pulseaudio():
    try:
        result = subprocess.run(["pactl", "info"], capture_output=True, text=True)
        return result.returncode == 0
    except Exception as e:
        logging.error(f"检查PulseAudio失败: {str(e)}")
        return False

# 初始化传感器
pir = MotionSensor(4)
monitor_on = False
audio_unmuted = False
timer = time.time()

while True:
    if pir.motion_detected:
        if not monitor_on:
            # 启动显示器
            os.system("xset dpms force on")
            # 检查PulseAudio状态
            if not check_pulseaudio():
                logging.info("PulseAudio未运行，尝试启动...")
                subprocess.run(["pulseaudio", "--start"], env=os.environ)
                time.sleep(2)
            # 取消静音
            result = subprocess.run(
                ["/usr/bin/pactl", "set-sink-mute", default_sink, "0"],
                env=os.environ,
                capture_output=True,
                text=True
            )
            if result.returncode != 0:
                logging.error(f"取消静音失败: {result.stderr}")
            else:
                logging.info(f"{datetime.now().strftime('%Y-%m-%d %H:%M:%S')} - 已取消静音，默认sink: {default_sink}")
            monitor_on = True
            audio_unmuted = True
        timer = time.time()
    elif time.time() - timer > 60:
        if monitor_on:
            # 关闭显示器
            os.system("xset dpms force off")
            # 静音
            result = subprocess.run(
                ["/usr/bin/pactl", "set-sink-mute", default_sink, "1"],
                env=os.environ,
                capture_output=True,
                text=True
            )
            if result.returncode != 0:
                logging.error(f"静音失败: {result.stderr}")
            else:
                logging.info(f"{datetime.now().strftime('%Y-%m-%d %H:%M:%S')} - 已静音，默认sink: {default_sink}")
            monitor_on = False
            audio_unmuted = False
    time.sleep(0.1)

四、重新加载并测试服务 #

修改完配置后，执行以下命令更新并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart motion-sensor.service
# 查看服务状态
sudo systemctl status motion-sensor.service
# 实时查看服务日志
journalctl -u motion-sensor.service -f

如果还有错误，日志里会显示具体的失败原因（比如PulseAudio连接拒绝），可以进一步排查。

总结 #

核心问题是systemd服务运行时没有加载用户PulseAudio会话所需的环境变量，尤其是XDG_RUNTIME_DIR，同时要确保服务在PulseAudio启动后再运行。通过调整systemd配置和脚本中的环境变量设置，就能解决pactl执行失败的问题。

备注：内容来源于stack exchange，提问作者PV3