You need to enable JavaScript to run this app. PHP CURL调用PrintNode API提交打印任务报错BadRequest:缺少content字段
优惠活动
大模型
产品
解决方案
定价
更多

PHP CURL调用PrintNode API提交打印任务报错BadRequest:缺少content字段

PrintNode提交打印作业BadRequest错误排查

报错现象

调用PrintNode打印作业接口时,持续收到格式类错误提示:

错误码:BadRequest
错误信息:请求体格式错误:必须提供请求体的content字段

问题根因定位

从提供的代码片段来看,有几个容易导致服务端解析失败的问题:

  • CURLOPT_HTTPHEADER 参数传值格式不符合扩展要求
    原代码直接把字符串格式的Content-Type: application/json传入CURLOPT_HTTPHEADER,但PHP cURL扩展要求该参数必须传入索引数组,每个数组元素对应一条独立的HTTP头内容。传参格式错误会导致自定义请求头无法被正确附加到请求中,服务端无法按照JSON规则解析请求体结构,就会误判请求缺少content字段,返回BadRequest错误。
  • PDF URI的外部可访问性校验
    代码通过plugin_dir_url()拼接的PDF路径,需要提前验证是公网可直接匿名访问的有效地址,不能是需要站点登录鉴权、仅在内网环境下可达的路径。PrintNode服务端拉取pdf_uri类型的打印内容时,无法携带站点的登录Cookie或其他鉴权信息,如果地址本身无法被外部网络访问,即使请求结构完全正确,也会触发内容校验不通过的错误。
  • 调试配置辅助定位
    开发调试阶段可以临时开启两个cURL配置,快速缩小问题范围:
    • 设置curl_setopt($ch, CURLOPT_VERBOSE, true),输出完整的请求/响应交互日志,确认实际发出的请求头、请求体内容和预期完全一致
    • 执行请求后捕获curl_error($ch)的返回值,排除网络连接层面的异常问题

修正后的参考代码

$pdf_path = plugin_dir_url( __FILE__ ) .  'pdfs/Order8221.pdf';

$url = 'https://api.printnode.com/printjobs';
$data_array = array(
    'printerId' => 70029019,
    'title' =>  'My test print',
    'contentType' => 'pdf_uri',
    'content' => $pdf_path,
    'source' => 'api doc'
);

$data = json_encode($data_array);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_USERPWD, '你的PrintNode API 密钥' . ":" . '');
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
// 修正:HTTPHEADER参数需传入数组格式
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 调试阶段可开启详细日志
// curl_setopt($ch, CURLOPT_VERBOSE, true);

$resp = curl_exec($ch);

// 调试阶段可输出错误和接口返回内容
// echo 'cURL错误:' . curl_error($ch);
// print_r('接口返回:' . $resp);

curl_close($ch);

内容的提问来源于stack exchange,提问作者Dexter Lautenbach

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 23:06:00