Mastodon自定义实例无法搜索到用户，已实现WebFinger仍未解决

以下是针对你的情况，可能导致Mastodon无法搜索到用户的几个关键排查方向：

• 检查响应Content-Type头
  Mastodon要求WebFinger响应的Content-Type必须是application/jrd+json（优先）或application/json。如果返回的是text/plain或其他类型，即便JSON格式正确也会被忽略。你可以用命令验证：

  curl -I https://wildleague.org/.well-known/webfinger?resource=acct:ropoko@wildleague.org
  

  确保输出中包含Content-Type: application/jrd+json或application/json。

• 验证WebFinger核心字段的准确性
  除了你调整过的字段，还有几个细节必须严格符合要求：

  • subject字段必须与请求的acct:ropoko@wildleague.org完全一致（大小写、格式无偏差）；
  • aliases数组必须包含用户的ActivityPub Actor ID（例如https://wildleague.org/users/ropoko），且该ID对应的地址能返回合法的ActivityPub Actor对象；
  • links数组必须包含两个关键条目：
    • rel为self：type设为application/activity+json，href指向上述ActivityPub Actor URL；
    • rel为http://webfinger.net/rel/profile-page：type设为text/html，href指向用户的网页版个人主页（若存在）。

• 确认CORS配置正确
  Mastodon实例会跨域请求你的WebFinger接口，若服务器未配置CORS，请求会被拦截。需在响应头中添加：

  Access-Control-Allow-Origin: *
  Access-Control-Allow-Methods: GET
  Access-Control-Allow-Headers: Accept
  

  确保这些头在WebFinger响应中存在。

• 检查ActivityPub Actor的有效性
  Mastodon搜索用户时，会进一步请求WebFinger返回的Actor地址。需确保该地址：

  • 返回200状态码，且JSON符合ActivityPub规范；
  • 包含id（与WebFinger中aliases的对应值一致）、type: "Person"、inbox、outbox、publicKey等必填字段；
  • 同样配置了正确的CORS头。

• 排查缓存与网络问题

  • Mastodon会缓存WebFinger数据，若之前配置有误，修复后可能需要等待缓存过期（通常数小时到1天），或尝试搜索完整的@ropoko@wildleague.org地址触发重新请求；
  • 确认你的域名wildleague.org的HTTPS证书有效（非自签）、DNS解析正常，WebFinger接口能被公网正常访问（无防火墙/CDN拦截）。

• 核对RFC 7033规范细节
  确保WebFinger响应没有违反RFC 7033：比如字段名大小写敏感（如subject不能写成Subject）、数组类型字段必须是数组而非单个字符串、无多余顶级字段等。

内容的提问来源于stack exchange，提问作者Ropoko