使用PyQt5开发媒体播放器时无法通过本地路径打开视频文件

错误原因 #

代码的核心问题出在本地路径转QUrl的逻辑错误：

• QMediaContent需要接收带资源协议标识的完整QUrl对象，原代码调用QUrl(videoPath).path()相当于把Url的协议前缀剥离，只保留了纯路径字符串，QMediaContent无法识别该路径对应的资源类型
• 直接给QUrl构造函数传入本地文件路径不会自动添加file://协议前缀，生成的Url本身就是无效状态，不符合QMediaPlayer的资源加载要求

修复方案 #

使用Qt提供的QUrl.fromLocalFile()方法处理本地路径，这个方法会自动适配不同操作系统的路径格式，生成带file://协议的合规QUrl对象，修正后的代码如下：

def openVideo(self, videoPath):
    if videoPath.strip():
        # 从本地文件路径生成合规QUrl
        local_media_url = QUrl.fromLocalFile(videoPath)
        self.mediaPlayer.setMedia(QMediaContent(local_media_url))
        self.playButton.setEnabled(True)
        self.mediaPlayer.play()

可选调试技巧 #

如果修改后仍然无法播放，可以在生成local_media_url后添加一行打印代码，确认Url生成是否正确：

print(local_media_url.toString())

正常输出应该为file:///开头的完整路径格式，比如Windows下输出file:///C:/Users/xxx/Videos/test.mp4，Linux/macOS下输出file:///home/xxx/Videos/test.mp4

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