Ubuntu22.04下Qt AppImage无法播放视频：找不到mediaplayer服务

问题背景 #

• 环境：Ubuntu 22.04，Qt 5.15.2
• 现象：应用编译无错误，Qt Creator调试模式下视频可正常播放，但打包为AppImage后视频无法播放，报错：

  defaultServiceProvider::requestService(): no service found for - "org.qt-project.qt.mediaplayer"
  

• 对比：旧版本AppImage可正常播放视频，新版本无法播放

已尝试操作 #

• 安装了所有推荐依赖库：

  sudo apt-get update
  sudo apt-get -y install \
              libclang-dev \
              libdbus-1-dev \
              libfontconfig1-dev \
              libfreetype6-dev \
              libgl1-mesa-dev \
              libharfbuzz-dev \
              libx11-dev \
              libx11-xcb-dev \
              libxcb-glx0-dev \
              libxcb-icccm4-dev \
              libxcb-image0-dev \
              libxcb-keysyms1-dev \
              libxcb-randr0-dev \
              libxcb-render-util0-dev \
              libxcb-shape0-dev \
              libxcb-shm0-dev \
              libxcb-sync0-dev \
              libxcb-xfixes0-dev \
              libxcb-xinerama0-dev \
              libxcb1-dev \
              libxext-dev \
              libxfixes-dev \
              libxi-dev \
              libxkbcommon-dev \
              libxkbcommon-x11-dev \
              libxrender-dev \
              libpulse-dev \
              libunwind-dev \
              libgstreamer1.0-dev \
              libgstreamer-plugins-base1.0-dev \
              libgstreamer-plugins-bad1.0-dev \
              gstreamer1.0-plugins-base \
              gstreamer1.0-plugins-good \
              gstreamer1.0-plugins-bad \
              gstreamer1.0-plugins-ugly \
              gstreamer1.0-gl \
              gstreamer1.0-libav \
              gstreamer1.0-qt5 \
              gstreamer1.0-tools \
              libqt5multimedia5-plugins \
              libqt5core5a \
              libfuse2 \
              ffmpeg \
              ffmpegthumbnailer \
              autoconf \
              automake \
              build-essential \
              cmake \
              git-core \
              libass-dev \
              libgnutls28-dev \
              libmp3lame-dev \
              libsdl2-dev \
              libtool \
              libva-dev \
              libvdpau-dev \
              libvorbis-dev \
              meson \
              ninja-build \
              pkg-config \
              texinfo \
              yasm \
              zlib1g-dev \
              ffmpegthumbs \
              ffmpeg-doc \
              qtbase5-dev \
              qtdeclarative5-dev \
              libavcodec-dev \
              qml-module-qtmultimedia \
              qml-module-qt-labs-settings \
              qml-module-qtquick-controls2 \
              qml-module-qtquick-layouts \
              qml-module-qtquick-window2 \
              qml-module-qtquick-dialogs \
              qml-module-qtquick-controls \
              binutils \
              fuse \
              libglib2.0-0
  

• 通过aqt安装带qtmultimedia的Qt：

  aqt install-qt --outputdir ./Qt linux desktop 5.15.2 --archives qtmultimedia
  

解决操作步骤 #

1. 确认Qt Multimedia插件被正确打包 #

Qt多媒体服务依赖特定插件，需确保这些文件被包含进AppImage：

• 找到Qt安装目录下的插件路径，比如./Qt/5.15.2/gcc_64/plugins/mediaservice
• 检查AppDir（打包前的目录）的usr/plugins/mediaservice下是否有libgstaudiodecoder.so、libgstmediaplayer.so等插件
• 如果缺失，手动复制上述Qt目录下的插件到AppDir对应路径

2. 补全GStreamer相关插件和库 #

Qt Multimedia在Linux上依赖GStreamer，AppImage需要包含核心解码插件：

• 从系统目录/usr/lib/x86_64-linux-gnu/gstreamer-1.0复制核心插件（如libgstlibav.so、libgstvp8.so、libgstreamer-plugins-base.so）到AppDir的usr/lib/x86_64-linux-gnu/gstreamer-1.0目录
• 确保AppDir的usr/lib下包含libgstreamer-1.0.so、libgstapp-1.0.so等基础库

3. 配置AppRun脚本的环境变量 #

修改AppRun脚本，确保Qt和GStreamer能正确加载插件：

#!/bin/sh
HERE=$(dirname "$(readlink -f "${0}")")
export QT_PLUGIN_PATH="${HERE}/usr/plugins"
export GST_PLUGIN_PATH="${HERE}/usr/lib/x86_64-linux-gnu/gstreamer-1.0"
export LD_LIBRARY_PATH="${HERE}/usr/lib:${HERE}/usr/lib/x86_64-linux-gnu:${LD_LIBRARY_PATH}"
exec "${HERE}/usr/bin/your_app_executable" "$@"

替换your_app_executable为你的应用可执行文件名

4. 使用linuxdeployqt带正确参数打包 #

用linuxdeployqt打包时，强制指定包含多媒体插件：

linuxdeployqt your_app.desktop -appimage -extra-plugins=mediaservice,multimediawidgets -verbose=2

• -extra-plugins参数确保多媒体相关插件被收集
• -verbose=2可查看打包日志，确认插件是否被正确包含

5. 验证打包后的AppImage完整性 #

挂载AppImage检查内部结构：

./YourApp.AppImage --appimage-mount

重点检查：

• usr/plugins/mediaservice下的插件是否齐全
• usr/lib下的Qt多媒体库是否存在
• usr/lib/x86_64-linux-gnu/gstreamer-1.0下的GStreamer插件是否完整

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