“签名验证错误”通常因timestamp超时窗、nonce不唯一、URL编码失真、缓存键缺失用户上下文或签名拼接不规范导致，需逐项校验时间戳、随机数、传输完整性、缓存键结构及参数排序规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy时收到“签名验证错误”提示，该问题通常源于客户端生成的timestamp或nonce不符合服务端校验规则，导致验签失败。以下是针对性排查步骤：
一、检查timestamp是否在允许时间窗口内
WorkBuddy服务端默认仅接受与当前UTC时间偏差±5分钟以内的timestamp值，超出范围将直接拒绝请求。必须使用Unix时间戳（单位：秒），且需基于协调世界时计算，避免本地时区干扰。
1、在客户端代码中，使用DateTimeOffset.UtcNow.ToUnixTimeSeconds()（C#）或time.time()（Python）获取当前UTC秒级时间戳。
2、确认未误用DateTime.Now.ToUniversalTime().ToUnixTimeSeconds()等易受本地系统时钟偏移影响的方式。
3、打印并记录请求发出前的timestamp值，与服务端接收到请求时的DateTimeOffset.UtcNow.ToUnixTimeSeconds()做差值比对，确保绝对值≤300。
二、验证nonce是否满足唯一性与格式要求
nonce用于防止重放攻击，必须为每次请求生成全局唯一、不可预测的字符串，且服务端会通过Redis或内存缓存进行去重校验。若重复或格式异常，将触发签名验证失败。
1、检查nonce生成逻辑是否调用密码学安全随机源，例如C#中使用RandomNumberGenerator.GetBytes()配合Base64编码，而非Guid.NewGuid().ToString()（存在碰撞风险）。
2、确认nonce字符串不含空格、换行符、不可见Unicode字符；建议使用正则^[a-zA-Z0-9_-]{16,64}$进行前端预校验。
3、在服务端日志中搜索"duplicate nonce"或"invalid nonce format"关键字，定位具体拦截原因。
三、核对timestamp与nonce是否被意外URL编码或截断
当timestamp或nonce作为查询参数或Header传递时，若经历多次URL编码、代理自动解码或CDN处理，可能导致值失真，进而使签名串与服务端重建结果不一致。
1、检查HTTP请求原始载荷（如Fiddler或Wireshark抓包），确认X-Timestamp与X-Nonce Header值与客户端构造值完全一致，无额外空格或换行。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、若通过Query传递，确保sign参数始终置于URL末尾，且timestamp、nonce字段未被网关/反向代理自动重写或过滤。
3、禁用客户端SDK中自动URL编码timestamp/nonce的选项（如有），改由服务端统一按原始字节流参与签名计算。
四、确认服务端缓存键包含用户上下文防跨账号冲突
WorkBuddy对nonce的缓存键设计必须绑定用户标识（如app_id或user_id），否则不同账号共用同一nonce可能被误判为重复，引发非预期验签失败。
1、查看服务端nonce缓存逻辑，确认Redis Key形如"nonce:{app_id}:{nonce}"或"nonce:{user_id}:{nonce}"，而非仅"nonce:{nonce}"。
2、检查客户端请求Header中是否携带有效X-App-ID或X-User-ID，且该值与缓存键构造所用字段严格匹配。
3、在Redis中执行KEYS "nonce:*"命令抽查缓存键结构，验证是否存在未携带上下文的裸nonce键。
五、比对签名前参数拼接顺序与大小写规范
timestamp与nonce参与签名时，必须与其他参数（如method、path、body hash）按固定规则排序拼接。任意字段大小写错误、顺序错乱或空格残留均会导致哈希值不一致。
1、确认所有参与签名的key（包括timestamp、nonce）全部转换为小写后再排序，例如"timestamp"不可写作"Timestamp"。
2、检查拼接模板是否严格遵循method+"\n"+path+"\n"+timestamp+"\n"+nonce+"\n"+bodyHash格式，每段之间为LF（\n），无CR（\r）或多余空行。
3、对bodyHash，须使用原始请求体字节流计算SHA256并转为小写hex字符串，禁止使用JSON解析后结构体序列化的结果。
