回调URL校验失败主因是飞书IP白名单未配置，需确认服务器放行飞书IP段、验证GET响应echostr、检查HTTPS证书有效性及反向代理拦截问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在将WorkBuddy接入飞书时，回调URL校验失败，常见原因之一是服务器未通过飞书的IP白名单校验。飞书在验证回调URL时会发起HTTP GET请求，并要求目标服务器响应指定的echostr参数，同时该请求必须源自飞书官方IP段。以下是几种可立即执行的排查与修复方法：
一、确认并配置飞书官方IP白名单
飞书回调请求仅从其公布的固定IP段发起，若您的服务器防火墙、安全组或反向代理（如Nginx、Cloudflare）拦截了这些IP，校验请求将无法到达应用服务，导致超时或403错误。
1、访问飞书开放平台文档中的IP地址段列表页面，获取最新IPv4和IPv6地址范围。
2、登录您的云服务器控制台（如阿里云ECS、腾讯云CVM），进入安全组规则配置页，添加入方向规则：协议类型为HTTP/HTTPS（端口80/443），源IP设置为飞书全部IPv4网段（例如：101.32.0.0/15、119.3.0.0/16等），授权策略设为允许。
3、若使用Nginx，检查server块中是否启用allow/deny指令，确保未全局deny all且未遗漏飞书IP段；可在location / 配置块中显式添加：allow 101.32.0.0/15; allow 119.3.0.0/16; deny all;
二、验证Web服务器能否接收外部GET请求
飞书校验流程本质是向您填写的回调URL发送一次GET请求，附带两个查询参数：echostr和timestamp。服务器需原样返回echostr作为HTTP响应体，且状态码为200。任何重定向、认证拦截或路径不匹配都会导致失败。
1、在浏览器中手动模拟飞书请求，将回调URL后拼接?echostr=abc123×tamp=1717025400，访问并观察响应内容与状态码。
2、登录服务器终端，使用curl命令复现请求：curl -v "https://your-domain.com/callback?echostr=test×tamp=$(date +%s)"，确认返回体仅为test且无额外HTML头或JSON包装。
3、检查应用框架路由是否严格匹配回调路径（如/feishu/event），排除因大小写、斜杠结尾或路由前缀（如/api/v1）导致的404。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、检查SSL证书与域名解析有效性
飞书强制要求回调URL使用HTTPS协议，且证书必须由受信任CA签发、域名完全匹配、未过期。若证书链不完整、使用自签名证书或SNI配置异常，飞书客户端将拒绝建立TLS连接。
1、使用在线工具（如SSL Labs SSL Test）检测域名证书状态，确认评级为A及以上，无“Chain issues”或“Expired”提示。
2、在服务器上执行：openssl s_client -connect your-domain.com:443 -servername your-domain.com，查看输出中Verify return code是否为0，以及Subject Alternative Name是否包含当前域名。
3、检查DNS解析是否生效：运行dig +short your-domain.com A，确保返回的是您实际部署服务的公网IP，而非CDN或测试环境IP。
四、审查反向代理与WAF中间件行为
若您使用Nginx、Apache或云WAF（如阿里云WAF、腾讯云网站管家），它们可能对GET请求执行默认过滤策略，例如拦截无User-Agent头、限制请求频率、或误判echostr参数为攻击载荷。
1、临时关闭WAF防护或切换至“观察模式”，再次触发飞书URL校验，观察是否通过。
2、在Nginx配置中，在server块内添加：underscores_in_headers on; ignore_invalid_headers off;，防止因飞书请求头含特殊字段被丢弃。
3、检查access_log与error_log，搜索包含“echostr”或“feishu”的日志行，确认请求是否抵达Nginx，以及是否被rewrite、return或proxy_pass中途截断。
