PyQt基于QMediaPlayer、QMediaPlaylist实现视频无限循环播放失效排查

你当前实现的循环播放失效、出现黑屏的问题，和循环播放模式的配置无关，完全是播放列表的两处配置错误导致的：

• 索引设置越界：你仅向播放列表添加了1个本地视频，QMediaPlaylist的索引从0开始计数，合法索引仅为0，但你调用了playlist.setCurrentIndex(1)，指向了不存在的媒体项，播放器加载不到有效内容，自然会显示黑屏。
• 局部变量被回收：你在__init__方法中创建的playlist是临时局部变量，构造方法执行完成后，这个对象会被Python的垃圾回收机制销毁，后续关联到播放器的播放列表实例已经失效，也会直接引发播放异常。

对照上述问题调整播放列表的配置逻辑，核心修改点有两个：

1. 移除越界的setCurrentIndex(1)调用，单媒体添加完成后播放列表默认选中索引0的媒体项；如果需要显式指定当前播放项，必须设置合法的0值索引。
2. 将playlist实例存为类的成员变量，延长对象生命周期，避免被垃圾回收。

可直接替换的修正后核心代码如下：

class VideoPlayer(QWidget):
  def __init__(self, video_path, parent=None):
    super(VideoPlayer, self).__init__(parent)
    self.mediaPlayer = QMediaPlayer(None, QMediaPlayer.VideoSurface)

    videoWidget = QVideoWidget()
    layout = QVBoxLayout()
    layout.addWidget(videoWidget)
    self.setLayout(layout)

    self.mediaPlayer.setVideoOutput(videoWidget)

    # 修正后播放列表配置
    self.playlist = QMediaPlaylist()
    self.playlist.addMedia(QMediaContent(QUrl.fromLocalFile(video_path)))
    self.playlist.setCurrentIndex(0)
    self.playlist.setPlaybackMode(QMediaPlaylist.CurrentItemInLoop)
    self.mediaPlayer.setPlaylist(self.playlist)

• 初始化完成后可先打印播放列表状态：确认self.playlist.mediaCount() ==1、self.playlist.currentIndex() ==0，不存在索引越界问题
• 如果调整后仍有异常，可临时切换播放模式为QMediaPlaylist.Loop（整个播放列表循环），单文件场景下和CurrentItemInLoop效果完全一致，可排除模式配置的影响
• 绑定QMediaPlayer的error信号打印具体报错，可快速定位是媒体路径问题还是播放列表关联问题

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