我来帮你排查这个视频Base64编码传输后仅显示单帧的问题——大概率是编码/解码环节的数据损坏或处理不当导致的，毕竟视频文件体积大，很容易在传输、解码步骤出岔子。结合你用树莓派录制、Laravel接收的场景，给你一步步拆解排查和修复方案：

1. 先确认Python端编码逻辑没问题 #

首先要确保Python这边的编码没有破坏视频二进制数据：

• 必须用二进制模式读取视频文件（rb），别用文本模式，否则会因为编码转换损坏数据
• 编码后的Base64字符串不要带换行符（别用base64.encodebytes，要用base64.b64encode，它不会自动加换行）
• 发送请求时尽量用JSON格式传递，避免URL编码导致字符串截断

给你一份标准的Python编码发送示例：

import base64
import requests

# 读取视频并编码为Base64字符串
with open("/path/to/your/raspberry/video.mp4", "rb") as video_file:
    video_bytes = video_file.read()
    video_base64 = base64.b64encode(video_bytes).decode("utf-8")

# 发送到Laravel接口
try:
    response = requests.post(
        "http://your-laravel-domain/api/save-video",
        json={"video_data": video_base64},
        headers={"Content-Type": "application/json"}
    )
    print(f"请求状态码: {response.status_code}")
except Exception as e:
    print(f"发送失败: {str(e)}")

2. Laravel端解码保存的关键修正 #

这是最容易出问题的环节，以下是你可能踩的坑和修复代码：

坑1：没处理Data URI前缀（如果有的话） #

如果Python端不小心带上了data:video/mp4;base64,这类前缀，必须先移除再解码，否则解码出来的文件肯定损坏：

public function saveVideo(Request $request)
{
    $base64Str = $request->input('video_data');
    
    // 移除可能的Data URI前缀
    if (str_starts_with($base64Str, 'data:')) {
        $base64Str = preg_replace('#^data:video/[^;]+;base64,#', '', $base64Str);
    }

    // 解码：第二个参数设为true，解码失败时返回false，方便排查
    $videoBytes = base64_decode($base64Str, true);
    if ($videoBytes === false) {
        return response()->json(['error' => 'Base64解码失败'], 400);
    }

    // 保存文件
    $savePath = storage_path('app/videos/saved_' . time() . '.mp4');
    file_put_contents($savePath, $videoBytes);

    // 可选：验证文件是否为有效视频
    $finfo = new \finfo(FILEINFO_MIME_TYPE);
    $mimeType = $finfo->file($savePath);
    if (!str_contains($mimeType, 'video/')) {
        unlink($savePath); // 删除无效文件
        return response()->json(['error' => '保存的文件不是有效视频'], 400);
    }

    return response()->json(['message' => '视频保存成功', 'path' => $savePath]);
}

坑2：内存/请求大小限制 #

视频文件大的话，PHP的默认配置可能截断请求：

• 修改php.ini里的参数：
  • post_max_size = 64M（根据你的视频大小调整，比如100M）
  • upload_max_filesize = 64M
  • memory_limit = 128M
• 重启PHP-FPM或Apache生效

坑3：Base64字符串长度不合法 #

Base64字符串必须是4的倍数，否则解码会丢失数据。可以在Laravel端补全填充：

// 补全Base64的=填充符
$base64Str = str_pad($base64Str, strlen($base64Str) + (4 - strlen($base64Str) % 4) % 4, '=');

3. 最后验证 #

保存完视频后，用ffmpeg检查文件完整性：

ffmpeg -i /path/to/laravel/storage/app/videos/saved.mp4

如果输出里没有错误信息，说明文件是正常的，再用播放器打开试试。

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