Gravatar头像需用md5(trim(strtolower($email)))生成哈希，URL格式为https://gravatar.com/avatar/hash?s=80&d=mp；本地头像须唯一命名、双重校验类型、及时清理旧文件；前后端应统一返回avatar_url字段，避免混用逻辑；排查默认图需优先检查HTTP状态码与服务器权限。
Gravatar 头像怎么用 get_avatar_url() 拿到正确 URL
gravatar 不是直接给图片，而是靠邮箱哈希拼 url。很多人传了邮箱却显示默认头像，大概率是没做 trim() 和 strtolower() —— gravatar 对大小写和空格敏感。
实操建议：
-
md5(trim(strtolower($email)))是必须步骤，漏掉任意一个都可能返回 404 或默认图 - URL 模板是
https://www.gravatar.com/avatar/<code>hash?s=80&d=mp，其中s是尺寸，d是 fallback 策略（mp表示 mystery person，默认灰头像） - 别用
get_avatar()这类封装函数（比如 WordPress 的），它可能自动加缓存逻辑或强制 HTTPS，调试时反而难定位问题
本地头像上传后怎么安全存、怎么防覆盖
用户上传头像不是存到 /uploads/avatar/123.jpg 就完事。文件名不唯一、没校验类型、没清理旧文件，很快就会出乱子。
实操建议：
- 用用户 ID + 时间戳 + 随机字符串生成文件名，例如
uid_4567_1715238901_abcd1234.jpg，避免冲突和猜测路径 - 上传时必须检查
$_FILES['avatar']['type']和用getimagesize()双重验证是否真为图片，光靠后缀没用 - 每次新上传，先查数据库里有没有旧头像路径，有就
unlink()掉——不然磁盘悄悄爆满，连错误日志都不报
前端显示时怎么统一处理 Gravatar 和本地头像
混用两种来源，最怕的是 HTML 里写两套 <img> 标签、JS 里反复判断、CSS 再单独适配。一改全崩。
实操建议：
- 后端统一返回一个
avatar_url字段，值要么是 Gravatar URL，要么是本地绝对路径（如/static/avatars/uid_4567_abc.jpg），前端只认这个字段 - 本地路径务必走 Web Server 直接服务（别用 PHP
readfile()输出），否则并发一高就拖慢整个页面 - 加个
onerror="this.src='/static/default-avatar.png'"，但仅作兜底——不要依赖它修复路径错误，那说明后端逻辑已经漏了校验
为什么头像突然变回默认图？常见断点在哪
不是代码写错，往往是环境或配置漂移导致的静默失败：Gravatar 域名被墙、本地路径权限变了、CDN 缓存了 404 响应。
排查优先级：
- curl -I 直接请求返回的
avatar_url，看 HTTP 状态码是不是 200；如果是 302 跳转，检查跳转目标是否可达 - 查 Nginx/Apache 日志里对应路径的 403/404 记录，特别是上传目录的
open_basedir或 SELinux 上下文是否锁死了读取 - Gravatar 请求如果返回 429，说明同一 IP 短时间请求太多——别在循环里批量渲染用户头像时直接拼 URL，加一层内存缓存或预加载
真正麻烦的从来不是“怎么显示”，而是“什么时候不该显示”——比如用户刚注册还没上传、邮箱格式非法、Gravatar 返回了 200 但 body 是 HTML 错误页。这些边界得在取 URL 的那一刻就拦住，而不是等 <img> 自己挂掉。
