FastAPI+ReactJS多视频上传后OpenCV仅处理首个视频问题排查

常见问题点及修复方案 #

1. 临时文件路径未独立处理 #

如果所有上传视频共用同一个临时文件路径，后续视频会直接覆盖前一个，导致OpenCV只能读取到第一个视频。修复时要为每个文件生成独立的临时存储路径：

from fastapi import FastAPI, File, UploadFile
import cv2
import tempfile
import os

app = FastAPI()

@app.post("/upload-videos/")
async def process_videos(files: list[UploadFile] = File(...)):
    processed_results = []
    for idx, file in enumerate(files):
        # 为每个视频创建独立临时文件
        with tempfile.NamedTemporaryFile(delete=False, suffix=os.path.splitext(file.filename)[1]) as temp_file:
            temp_file.write(await file.read())
            temp_file_path = temp_file.name
        
        # 初始化独立的VideoCapture实例
        video_cap = cv2.VideoCapture(temp_file_path)
        if not video_cap.isOpened():
            processed_results.append({
                "filename": file.filename,
                "status": "failed",
                "reason": "无法打开视频文件"
            })
            os.unlink(temp_file_path)  # 清理无效临时文件
            continue
        
        # 这里替换成你的视频处理逻辑，比如统计帧数、提取帧等
        total_frames = int(video_cap.get(cv2.CAP_PROP_FRAME_COUNT))
        processed_results.append({
            "filename": file.filename,
            "status": "success",
            "total_frames": total_frames
        })
        
        # 必须释放VideoCapture资源并删除临时文件
        video_cap.release()
        os.unlink(temp_file_path)
    
    return {"results": processed_results}

2. 资源未及时释放 #

如果循环中复用了同一个VideoCapture实例，或者处理完视频后未调用release()，会导致OpenCV占用文件句柄，后续视频无法正常读取。要保证每个视频对应独立的VideoCapture，处理完成立即释放资源。

3. 文件读取不完整 #

异步读取上传文件时，要使用await file.read()确保完整读取文件内容，避免后续视频文件内容为空导致无法解析。

4. 前端上传校验（辅助排查） #

确认前端FormData正确添加了所有视频文件，比如React端的示例代码：

const handleBatchUpload = async (selectedFiles) => {
  const formData = new FormData();
  selectedFiles.forEach(file => {
    formData.append("files", file);
  });
  // 发送POST请求到后端接口
  const response = await fetch("/upload-videos/", {
    method: "POST",
    body: formData
  });
};

关键调试技巧 #

• 在循环内打印每个文件的名称和video_cap.isOpened()的返回值，定位具体哪个视频处理环节出错。
• 检查临时文件目录，确认每个上传的视频都生成了对应的临时文件，且文件大小与原文件一致。

内容的提问来源于stack exchange，提问作者Inês