如何通过PHP API获取Facebook Long-Lived Access Token？

兄弟，我之前换Facebook长期令牌的时候也踩过几乎一模一样的坑！别着急，咱们一步步排查：

先确认换令牌的核心请求是否正确 #

这是最容易出错的地方，很多人会在这里栽跟头：

• 必须用GET请求（别用POST，Graph API这个接口只认GET），端点格式是 https://graph.facebook.com/v[你的API版本号]/oauth/access_token（建议用最新的稳定版本，比如v18.0）
• 四个必填参数一个都不能少，而且要完全对应：
  • client_id：和你生成短期令牌时用的同一个Facebook应用ID
  • client_secret：对应应用的密钥（注意别把这个泄露到前端，只在服务器端用）
  • grant_type：固定写死 fb_exchange_token
  • fb_exchange_token：你从API Explorer拿到的那个短期令牌

给你贴个最基础的PHP调用示例，你可以先跑这个测试：

// 替换成你自己的信息
$shortToken = '你的短期令牌';
$appId = '你的APP ID';
$appSecret = '你的APP密钥';
$apiVersion = 'v18.0';

// 拼接请求URL
$requestUrl = "https://graph.facebook.com/{$apiVersion}/oauth/access_token?client_id={$appId}&client_secret={$appSecret}&grant_type=fb_exchange_token&fb_exchange_token={$shortToken}";

// 发送请求并解析结果
$response = file_get_contents($requestUrl);
$result = json_decode($response, true);

if (isset($result['access_token'])) {
    echo "成功拿到长期令牌：" . $result['access_token'];
} else {
    // 重点！打印错误信息排查
    echo "出错了：";
    print_r($result);
}

检查短期令牌和应用的匹配性 #

• 确认短期令牌没过期：API Explorer生成的短期令牌有效期只有1小时，要确保你在过期前调用换令牌接口
• 别搞混应用：短期令牌是绑定到特定APP的，换令牌用的client_id必须和生成短期令牌的APP完全一致，不然肯定失败
• 检查应用状态：如果你的APP还没通过基本审核，只有开发者账号能使用，换令牌时别用非开发者的账号生成的短期令牌

如果用了Facebook SDK，检查SDK的使用逻辑 #

如果你是用官方SDK来调用的，要注意这几点：

• 确保SDK是最新版本，旧版本可能不兼容新的API端点
• 换令牌的正确方式是调用getLongLivedAccessToken()，而不是直接用原来的实例获取token
• 示例代码：

require_once 'vendor/autoload.php';

$fb = new Facebook\Facebook([
  'app_id' => $appId,
  'app_secret' => $appSecret,
  'default_graph_version' => $apiVersion,
]);

$oAuthClient = $fb->getOAuth2Client();
try {
    $longLivedToken = $oAuthClient->getLongLivedAccessToken($shortToken);
    // 这里拿到的才是长期令牌，要替换掉原来的短期令牌使用
    echo "长期令牌：" . $longLivedToken->getValue();
} catch(Facebook\Exceptions\FacebookResponseException $e) {
    echo "Graph API错误：" . $e->getMessage();
} catch(Facebook\Exceptions\FacebookSDKException $e) {
    echo "SDK错误：" . $e->getMessage();
}

• 如果你调用后getaccessToken()还是返回短期的，大概率是你没把新获取的长期令牌赋值给SDK实例，或者还在使用原来的会话数据

一定要看返回的错误信息 #

不管是直接调用API还是用SDK，出错时一定要打印完整的错误响应！比如：

• 错误码190：令牌过期或无效
• 错误码101：APP ID或密钥错误
• 错误码400：参数缺失或格式不对

根据错误信息去针对性排查，比瞎试效率高多了！

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