京东PHP SDK调用失败主因是sign签名错误：须剔除空值及sign字段后字典序排序参数，用原始未URL编码值拼接再MD5(app_secret)；订单接口时间需ISO8601格式且跨度≤7天；cURL需TLS1.2+并指定CA证书；商品接口需显式传fields参数如price,stockNum。
京东开放平台 PHP SDK 调用失败：签名错误 sign 不匹配
绝大多数 PHP 接口调用卡在第一步，不是授权失败，而是 sign 算错了。京东要求对请求参数（含公共参数）按字典序排序后拼接成字符串，再用 md5 + app_secret 加密——但很多人漏掉“排序前要剔除空值和 sign 字段本身”，或误把 app_key 当作 app_secret 参与计算。
实操建议：
- 用
ksort()对参数数组升序排列，再用http_build_query()拼接（注意不加?&），最后拼上app_secret再md5() - 京东接口要求所有参数值 URL 编码，但拼签时必须用原始未编码值（比如
name=苹果手机，拼签用苹果手机，不是%E8%8B%B9%E6%9E%9C%E6%89%8B%E6%9C%BA） - 推荐直接用京东官方 PHP SDK（
jingdong-sdk-php），但注意它默认不校验响应签名，上线前得自己补上verifyResponseSign()逻辑
同步订单数据时 jd.union.open.order.query 返回空或报错 40017
这个错误码代表“参数格式错误”，常见于时间范围设置不当。京东订单接口强制要求 startTime 和 endTime 必须是精确到秒的 ISO8601 格式（如 2024-05-20T00:00:00），且跨度不能超过 7 天，也不能早于 90 天前。
实操建议：
- 用
date('c', $timestamp)生成标准时间字符串，别手拼Y-m-d H:i:s或漏掉T和时区标识 - 首次全量同步不要设太宽的时间范围，先试
24 小时，确认能拿到数据再扩；否则容易触发限流，返回空数组却不报错 - 接口返回的
orderList是嵌套结构，实际订单在$resp['jd_union_open_order_query_response']['data']['orderList']下，别直接遍历顶层
PHP cURL 请求京东接口超时或 SSL 验证失败
本地开发能通，部署到生产环境就 CURLOPT_SSL_VERIFYPEER 报错或卡死，大概率是服务器 OpenSSL 版本太低或 CA 证书路径不对。京东接口强制 HTTPS，且部分节点只支持 TLS 1.2+。
实操建议：
- 检查
curl_version()['version_number'] >= 0x073a00（对应 cURL 7.58.0+），旧版本默认不支持 TLS 1.2 - 显式设置
CURLOPT_SSLVERSION => CURL_SSLVERSION_TLSv1_2，避免协商降级 - 不要关
CURLOPT_SSL_VERIFYPEER，改用CURLOPT_CAINFO指向系统可信证书路径（如/etc/ssl/certs/ca-certificates.crt）
商品数据同步用 jd.kepler.item.detail.get 拿不到价格和库存
这个接口默认只返回基础信息（标题、类目、主图），价格和库存属于敏感字段，需单独申请权限并传参开启。即使你有权限，不加 fields 参数也拿不到。
实操建议：
- 调用时必须带
fields参数，值为逗号分隔字符串，例如price,stock,skuId；缺一个字段，对应数据就不返回 - 价格字段实际叫
jdPrice，不是price；库存字段是stockNum，不是stock；字段名大小写必须完全匹配文档 - 单次最多查 20 个
skuId，超了会截断，别一股脑传 100 个 ID 还以为漏数据
京东接口的字段命名和权限粒度比想象中更碎，同一个业务场景可能要组合调用三四个不同接口才能凑齐完整数据，别指望一个 API 解决所有问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
