Vertex AI AutoML视频目标追踪批量预测报错：输入文件无有效实例

针对你遇到的BatchPrediction could not start because no valid instances were found in the input file报错，除了你已排查的点，还可以从以下方向检查：

1. JSONL文件编码或隐藏字符问题 #

• 确认JSONL文件为UTF-8无BOM编码：部分编辑器保存时会添加BOM头，导致Vertex AI解析失败。可通过file -i your_file.jsonl（Linux/macOS）检查编码，或用VS Code等工具重新保存为UTF-8无BOM格式。
• 排查不可见空白字符：用cat -A your_file.jsonl查看每行结尾，确保只有$（代表换行符），无全角空格、制表符等多余字符。

2. 视频文件兼容性问题 #

AutoML Video Object Tracking对视频有严格格式要求：

• 视频编码必须为H.264（AVC），音频编码可选AAC或无音频；
• 分辨率建议不超过1920x1080，时长在1秒到3小时之间；
• 用ffprobe命令验证参数：

  ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height,duration -of default=noprint_wrappers=1:nokey=1 your_video.mp4
  

• 确认视频未损坏：通过gsutil cat gs://your-bucket/your-video.mp4 | head -c 100检查是否能读取到正常的视频文件头。

3. 路径与文件名的大小写/特殊字符问题 #

• GCS路径大小写敏感，检查videoGcsUri中的桶名、文件名是否完全匹配，无拼写错误；
• 避免路径中出现空格、中文、特殊符号（如!@#），建议用下划线、短横线和字母数字组合命名。

4. 客户端库与API版本问题 #

• 检查google-cloud-aiplatform客户端库版本，旧版本可能存在解析bug：

  pip show google-cloud-aiplatform
  

  升级到最新稳定版：pip install --upgrade google-cloud-aiplatform；
• 确认初始化Vertex AI时指定了正确区域：

  import aiplatform
  aiplatform.init(project=PROJECT_ID, location="us-central1")
  

5. 输入文件与存储类别限制 #

• 单个JSONL文件不能超过1GB，过大的话拆分多个小文件再尝试；
• 确保视频和JSONL文件存储在标准存储类别，冷存储（如归档存储）无法被Vertex AI直接访问，需先恢复为标准存储。

6. 对象级权限覆盖问题 #

即使桶已配置Storage Object Viewer角色，对象自身的权限可能覆盖桶级设置：

• 用以下命令检查视频文件的对象权限：

  gsutil acl get gs://your-bucket/your-video.mp4
  

  确保没有拒绝Vertex AI服务账号访问的规则。

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