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
相关产品推荐
相关产品推荐

