Ubuntu22.04下ROS2开机自启音频播放失效问题排查

问题描述 #

在Ubuntu 22.04上开发的ROS2程序，逻辑为：目标未检测时无声音，检测到目标播放music1，目标丢失播放music2。手动运行时音频功能正常，但通过用户crontab设置开机自启后，仅音频部分失效。两台测试PC中一台正常、一台异常，需排查遗漏点或Ubuntu安装相关问题。

核心代码 #

int g_target_detecting_state = 0; // 全局变量保存状态

void clusteringNode::timer_callback()
{
   // ROS逻辑：判断目标状态并更新g_target_detecting_state
}

void followingSoundPlay(void)
{
    sf::SoundBuffer go_buffer, stop_buffer;

    if (!go_buffer.loadFromFile("audio/music1.wav") || !stop_buffer.loadFromFile("audio/music2.wav"))
    {
        std::cerr << "加载音频文件失败!";
    }

    sf::Sound go_sound, stop_sound;

    go_sound.setBuffer(go_buffer);
    stop_sound.setBuffer(stop_buffer);

    while(1)
    {
        if(g_target_detecting_state == 0)
        {
            go_sound.stop();
            stop_sound.stop();
        }
        else if(g_target_detecting_state == 1)
        {
            stop_sound.stop();
            go_sound.play();
        }
        else if(g_target_detecting_state == 2)
        {
            go_sound.stop();
            stop_sound.play();
        }

        std::this_thread::sleep_for(std::chrono::milliseconds(1000));
    }
}

int main(int nArgc,const char* pszArgv[])
{
    rclcpp::init(nArgc, pszArgv);

    auto node = std::make_shared<clusteringNode>();

    std::thread ros_thread([&](){
        rclcpp::spin(node);
    });
    std::thread play_thread(followingSoundPlay);

    if(ros_thread.joinable())
        ros_thread.join();
    if(play_thread.joinable())
        play_thread.join();

    rclcpp::shutdown();

    return 0;
}

排查方向 #

1. 音频文件路径问题

• Crontab执行时的工作目录并非程序所在目录，代码中使用的相对路径audio/music1.wav会找不到文件，手动运行时因为在程序目录所以正常。
  • 解决：改用绝对路径加载音频，比如/home/xxx/ros2_ws/src/your_package/audio/music1.wav；或者在crontab命令中先cd到程序目录再执行。
  • 验证：在crontab启动命令中添加日志，输出当前工作目录（pwd >> /tmp/cron_debug.log）；同时在代码的加载失败分支中输出当前路径（需包含<filesystem>头）：

    std::cerr << "当前路径: " << std::filesystem::current_path() << std::endl;
    

2. Crontab环境变量缺失

• 手动运行时的ROS2环境变量、音频系统环境变量在crontab中未加载，导致SFML无法访问音频设备。
  • 解决：在crontab的启动命令前加载必要环境变量，示例：

    @reboot /bin/bash -c "source /opt/ros/humble/setup.bash && source ~/ros2_ws/install/setup.bash && export DISPLAY=:0 && export XDG_RUNTIME_DIR=/run/user/$(id -u) && cd /path/to/your/program && ./your_ros2_node >> /tmp/cron_ros.log 2>&1"
    

  • 关键说明：
    • 加载ROS2的setup.bash确保节点正常运行；
    • 设置DISPLAY=:0和XDG_RUNTIME_DIR，因为PulseAudio依赖X11会话环境，crontab默认无此变量；
    • 验证：对比手动运行和crontab的环境变量（分别执行env >> /tmp/manual_env.log和在crontab命令中添加env >> /tmp/cron_env.log），找出缺失的关键变量。

3. 音频设备权限问题

• 异常PC可能未给crontab运行用户授予音频设备访问权限，或PulseAudio会话未初始化。
  • 解决：
    1. 检查用户是否在audio组：groups your_username，不在则添加：sudo usermod -aG audio your_username；
    2. 在crontab命令中指定PulseAudio服务器路径：export PULSE_SERVER=unix:/run/user/$(id -u)/pulse/native，确保连接到正确的用户音频会话。

4. SFML音频初始化检查

• 代码未验证音频设备是否可用，crontab环境下SFML可能无法获取设备但无报错提示。
  • 优化代码：在followingSoundPlay开头添加设备检查：

    sf::AudioDevice audio_device;
    if (!audio_device.isAvailable()) {
        std::cerr << "音频设备不可用!" << std::endl;
        return;
    }
    

  • 同时将错误输出重定向到日志文件，方便排查。

5. Ubuntu系统配置差异

• 两台PC的系统配置可能存在差异：
  • 异常PC未安装PulseAudio或服务未启动：检查状态systemctl --user status pulseaudio，未启动则设置开机自启：systemctl --user enable --now pulseaudio；
  • 异常PC未开启自动登录：PulseAudio通常在用户登录后初始化，自动登录的PC会提前建立会话，手动登录的PC在crontab执行时可能还无用户会话；
  • 验证：对比两台PC的crontab配置、音频服务状态、用户组权限、登录设置。

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