求助：通过Facebook Graph API发布360图片失败，元数据不生效

我来帮你排查下这个360图片通过Facebook Graph API发布不被识别的问题！手动上传能正常识别说明图片本身的元数据是没问题的，大概率是API请求里的参数配置或者提交方式有遗漏，下面是几个关键的检查点和解决办法：

1. 确保spherical_metadata参数完整且格式合规 #

Facebook Graph API要求发布360全景图时，必须显式传递spherical_metadata字段，而且里面的核心参数不能缺失。只传is_spherical: true有时候不够，最好补充全景图的像素尺寸等信息，让平台能准确识别。

一个标准的spherical_metadata配置示例：

{
  "is_spherical": true,
  "cropped": false,
  "full_pano_width_pixels": 8192,
  "full_pano_height_pixels": 4096,
  "pose_heading_degrees": 0,
  "pose_pitch_degrees": 0,
  "pose_roll_degrees": 0
}

注意：这里的宽高要和你实际的360图片像素完全匹配，pose参数是设置全景图的初始视角，不需要自定义的话设为0即可，但建议带上以避免识别异常。

2. 检查请求的参数传递方式 #

如果是通过multipart/form-data表单上传图片（大部分场景都是这样），必须把spherical_metadata转成JSON字符串传递，不能直接传对象。很多HTTP库或SDK如果直接传字典/对象，会导致参数被错误编码，Facebook无法解析。

举个Python requests库的正确示例：

import requests
import json

# 替换成你的页面ID和访问令牌
API_URL = "https://graph.facebook.com/v18.0/[PAGE-ID]/photos"
ACCESS_TOKEN = "YOUR_VALID_ACCESS_TOKEN"

# 构造参数：spherical_metadata要转成JSON字符串
post_data = {
    "access_token": ACCESS_TOKEN,
    "spherical_metadata": json.dumps({
        "is_spherical": True,
        "full_pano_width_pixels": 8192,
        "full_pano_height_pixels": 4096,
        "cropped": False
    })
}

# 读取本地360图片文件
files = {"file": open("your-360-photo.jpg", "rb")}

# 发送请求
response = requests.post(API_URL, data=post_data, files=files)
print(response.json())

如果用curl命令测试，应该这样写：

curl -X POST "https://graph.facebook.com/v18.0/[PAGE-ID]/photos" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@your-360-photo.jpg" \
  -F "spherical_metadata={\"is_spherical\":true,\"full_pano_width_pixels\":8192,\"full_pano_height_pixels\":4096}" \
  -F "access_token=YOUR_VALID_ACCESS_TOKEN"

3. 确认图片元数据未被剥离 #

虽然手动上传没问题，但有些上传工具或库会默认剥离图片的EXIF元数据（比如全景图的ProjectionType标签）。你可以用工具（比如ExifTool）检查下上传的图片是否保留了equirectangular投影相关的EXIF信息。不过Facebook主要依赖你传递的spherical_metadata参数，所以这个是次要检查项，优先确保参数正确。

4. 验证API版本和权限 #

• 确保使用的Graph API版本是v16.0及以上，旧版本对360图片的支持可能存在缺陷；
• 确认你的访问令牌拥有正确的权限：发布到主页需要publish_pages权限，发布到个人账号需要publish_posts权限，且应用已通过必要的审核（公开应用场景）。

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