做电商技术开发这么多年，对接过京东各类接口，最让人头疼的莫过于评论接口。它不像商品详情、关键字接口那样逻辑清晰、文档详尽，反而藏着太多“隐形门槛”——签名参数藏在社区沉帖里、主评追评分离存储、限流比想象中更严苛，甚至部分字段会临时变更，没有任何通知。
从第一次对接时连续10小时调试签名失败，到后来能稳定支撑日均8万次评论采集，4年间我踩过的坑不计其数，有好几次因为接口踩坑，熬夜改代码到凌晨，还被客户追责。今天就把这些血的教训、可直接复制复用的代码，以及接口不为人知的潜规则全抖出来，给做差评预警、评论分析、竞品监控的朋友避避雷，少走我当年的弯路。
返回json示例/[注册免费测试]
```Result Object:
{
"items": {
"real_total_results": 20000,
"total_results": 20000,
"page_size": 10,
"page": "1",
"item": [
{
"rate_content": "香气清雅舒适，粮香明显，口感绵甜柔和，尾净回甘，性价比高，包装大气，自饮送礼都有面。",
"rate_date": "2026-02-08 21:47:08",
"pics": [
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/389655/32/18343/118331/698893dcFc4aa003d/00a94b064058ce49.jpg",
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/396506/19/163/150413/698893dcF48c1a330/00a94b064087616b.jpg"
],
"rate_id": 103774150159104860,
"guid": "T6NdPsBziZktdR-PWqacyHmH",
"score": 5,
"display_user_nick": "勿忘初心0901",
"auction_sku": "42度 520mL 2瓶 双支装;",
"add_feedback": ""
},
{
"rate_content": "海之蓝一如既往的好喝",
"rate_date": "2026-02-08 19:18:17",
"pics": [
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/396042/11/2076/196681/698870f8F0fa0b2c0/00a942f5946b7280.jpg",
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/391729/36/16857/265891/698870f8F4046c3ca/00a942f59415e8ca.jpg"
],
"rate_id": 104035000164778060,
"guid": "T6NaOcRyiJwtdRyCXKGQwHmC",
"score": 5,
"display_user_nick": "心有所属属",
"auction_sku": "42度 480mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "物流速度很快，第二天就到了，包装完好，价格也很实惠，比超市还便宜一些，正好是年货，春节送人比较合适，海之蓝还是家庭型实用不错的",
"rate_date": "2026-02-08 16:14:08",
"pics": [
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/391719/12/18168/290843/69884390F022355fd/0015300400d2d853.jpg",
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/386871/26/22397/122938/698843c4F7c964ca9/00153004000f4025.jpg"
],
"rate_id": 104024350182724940,
"guid": "T6NaOcVzi5ktdRKEXKScyXuD",
"score": 5,
"display_user_nick": "浩1",
"auction_sku": "42度 480mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "口感层次丰富，喝起来很顺口，值得8星推荐",
"rate_date": "2026-02-08 09:41:07",
"pics": [
"https://img30.360buyimg.com/n0/s128x96_jfs/t1/391552/34/15346/106407/6987e9b3F772b8a8d/00a94374311b3d58.jpg"
],
"rate_id": 103940790169777230,
"guid": "T6NdMMN3j5UtdRyPXKGfwnyH",
"score": 5,
"display_user_nick": "jo",
"auction_sku": "42度 375mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "朋友介绍买的，还不错的哦，口感很好，下次继续购买的",
"rate_date": "2026-02-07 12:13:44",
"pics": [],
"rate_id": 104015050164818980,
"guid": "T6NaOcZyiJktdRyCU6eQyXiA",
"score": 5,
"display_user_nick": "vivian_yuanyuanyuan",
"auction_sku": "42度 520mL 2瓶 双支装;",
"add_feedback": ""
},
{
"rate_content": "............................................................",
"rate_date": "2026-02-05 16:39:45",
"pics": [],
"rate_id": 103761820166766700,
"guid": "T6NdPsF2gJ4tdRyAXKCex3-J",
"score": 5,
"display_user_nick": "st",
"auction_sku": "42度 520mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "不错，喝起来也很好，下次还会光顾的。",
"rate_date": "2026-02-05 15:10:55",
"pics": [],
"rate_id": 104000960171741470,
"guid": "T6NaOcd3gZotdR2HXKKZxHmG",
"score": 5,
"display_user_nick": "霍yt",
"auction_sku": "42度 520mL 2瓶 双支装;",
"add_feedback": ""
},
{
"rate_content": "此用户未填写评价内容",
"rate_date": "2026-02-03 13:06:00",
"pics": [],
"rate_id": 103972500171124960,
"guid": "T6NdMMB1jZwtdR2HWqScyXmC",
"score": 5,
"display_user_nick": "jd_42cup6rw5snw0a",
"auction_sku": "42度 480mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "此用户未填写评价内容",
"rate_date": "2026-02-03 11:30:04",
"pics": [],
"rate_id": 103400810159051170,
"guid": "T6NdPcd3gJ0tdR-PW6OZwXmE",
"score": 5,
"display_usernick": "jd逆水寒",
"auction_sku": "42度 375mL 6瓶 整箱装;",
"add_feedback": ""
},
{
"rate_content": "此用户未填写评价内容",
"rate_date": "2026-02-03 11:29:47",
"pics": [],
"rate_id": 103414190153355170,
"guid": "T6NdPcZziZUtdR-FWKOdwXmD",
"score": 5,
"display_user_nick": "j寒",
"auction_sku": "42度 520mL 2瓶 双支装;",
"add_feedback": ""
}
],
"good_rate": 0.98,
"page_count": 100,
"_ddf": "fqx"
},
"secache": "811e7e335214d85e402519cc52cc47dc",
"secache_time": 1770621801,
"secache_date": "2026-02-09 15:23:21",
## 一、初次翻车：混淆sign生成逻辑+漏传client_type，调试到凌晨三点
第一次对接京东评论接口，是帮商家做“差评实时预警系统”，核心需求是抓取指定SKU的最新评论，一旦出现1-2分差评，立即推送通知。我刚做完京东商品详情接口，想当然地把详情接口的签名逻辑照搬过来，结果连续10小时，接口只返回两种错误：`40001`签名无效、`40002`参数错误。
翻遍京东开放平台官方文档，只看到评论接口的基础参数，关于签名的细节只字未提，最后在开发者社区一篇3年前的沉帖里，才摸清两个致命错误：
1. 评论接口的sign生成，必须包含`client_type`参数，而商品详情接口不需要！这个参数是评论接口的专属必传项，漏传直接报签名错误，错误信息和“密钥错误”完全一致，新手根本无法区分；
2. 时间戳格式踩坑：京东评论接口要求`timestamp`必须是10位秒级时间戳，而商品详情接口支持10位秒级和13位毫秒级，我惯性用了毫秒级时间戳，导致签名加密结果和官方校验不一致，反复调试都找不到问题。
除此之外，评论接口的`method`参数必须传`jd.union.open.comment.get`，不能用商品详情的method，哪怕其他参数全对，也会返回空数据。那天对着官方示例，逐字符对比签名计算过程，反复测试了12次，终于磨出能稳定跑通的签名函数，把所有必传参数和注意事项都标了出来：
import hashlib
import time
import urllib.parse
def generate_jd_comment_sign(params, app_secret):
"""
京东评论接口签名生成（必传client_type+10位秒级时间戳，避坑重点！）
:param params: 请求参数（不含sign）
:param app_secret: 京东开放平台应用密钥
:return: 加密后的签名（大写）
"""
# 1. 强制添加评论接口专属必传参数，缺一个直接报错，新手最易漏传client_type
params["client_type"] = "pc" # 固定传pc或app，二者均可，不能省略
params["v"] = "2.0" # 接口版本固定2.0，漏传报40002
params["format"] = "json" # 固定返回格式json，不支持xml
params["timestamp"] = str(int(time.time())) # 必须10位秒级，毫秒级必错
params["method"] = "jd.union.open.comment.get" # 评论接口固定method，不能改
# 2. 过滤sign参数，按参数名ASCII升序排序（京东对排序敏感，差一个字符都不行）
sign_params = {k: v for k, v in params.items() if k != "sign" and v is not None}
sorted_params = sorted(sign_params.items(), key=lambda x: x[0])
# 3. 拼接参数为key=value&key=value格式，值需URL编码（保留-_.~，其他特殊字符转义）
query_str = "&".join([
f"{k}={urllib.parse.quote(str(v), safe='-_.~')}"
for k, v in sorted_params
])
# 4. 首尾拼接app_secret，MD5加密后转大写（和商品详情接口加密方式一致，但参数不同）
sign_str = f"{app_secret}{query_str}{app_secret}"
return hashlib.md5(sign_str.encode()).hexdigest().upper()
示例调用：抓取指定SKU的评论，page_size最大20，最多返回100页
if name == "main":
app_key = "your_jd_app_key" # 替换成自己的app_key
app_secret = "your_jd_app_secret" # 替换成自己的app_secret
sku_id = "1000283456789" # 京东SKU ID，只能传SKU，不能传商品主ID
params = {
"app_key": app_key,
"sku_id": sku_id,
"page": 1,
"page_size": 20, # 单页最多20条，超了返回空数据
# 显式指定返回字段，避免返回冗余数据，也避免漏字段
"fields": "id,nickname,score,content,images,create_time,after_comment,user_level"
}
# 生成签名并添加到参数中
params["sign"] = generate_jd_comment_sign(params, app_secret)
print("请求参数准备完成，可直接发起评论接口请求")
print("签名示例（前20位）：", params["sign"][:20])
```
