nginx 可用 try_files 检查图片存在性并返回默认占位图：单层 location 用 try_files $uri /img/placeholder.png；多路径场景配合 error_page 404 = /img/placeholder.svg 统一处理；注意文件权限、mime 类型及 alias/root 配置。

用 try_files 在图片路径不存在时返回默认占位图，核心是让 Nginx 主动检查请求的图片是否存在，不存在就跳转到一个固定路径（比如 /img/placeholder.png），而不是放任它返回 404。这比靠前端 onerror 更可靠、更早拦截，也避免了浏览器报错或白块。

基础写法：单层 location + try_files 直接兜底

适用于图片集中在某个路径下（如 /images/ 或 /img/）的场景：

• 确保该 location 使用 alias（推荐）或 root 正确指向图片实际存储目录
• 在 location 块中写：try_files $uri /img/placeholder.png;
• $uri 是原始请求路径，Nginx 按照 alias 或 root 映射后检查文件是否存在
• 如果不存在，就直接返回 /img/placeholder.png —— 这个路径需能被 Nginx 正常服务（即它本身也要有对应 location 或落在 root 范围内）

增强写法：配合 error_page 统一处理所有 404 图片

当图片分布在多个路径（如 /assets/、/uploads/、/cdn/），又想统一用同一个占位图时，更适合用 error_page 全局接管：

linux-sysadmin

Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...

下载

• 在 server 块顶部加：error_page 404 = /img/placeholder.svg;（注意等号，表示内部重定向，状态码仍为 200）
• 单独配置占位图路径：location = /img/placeholder.svg { root /usr/share/nginx/html; }
• 所有图片 location 中都用 try_files $uri =404; 显式触发错误（不写 =404，Nginx 可能直接返回 404 而不走 error_page）
• 这样只要任意图片 404，就会静默返回 SVG 占位图，用户无感知，状态码友好

注意事项：路径、权限与 MIME 类型必须到位

很多配置看似正确却返回 403 或空白，问题往往出在细节：

• /img/placeholder.svg 文件必须真实存在，且 Nginx 工作进程（如 www-data）有读取权限
• 确认 types 块已声明：image/svg+xml svg;，否则浏览器可能拒绝渲染 SVG
• 若用 alias 映射图片目录，占位图路径不能依赖同一 alias；建议对占位图单独用 root 或放在公共静态目录下
• 不要在 try_files 最后一项写绝对路径或带变量，只能是相对 URI 或命名 location

进阶技巧：按尺寸或类型返回不同占位图

如果业务需要语义化占位（例如“头像缺失”“商品图缺失”），可用 map 提取 URL 特征再选择占位图：

• 在 http 块定义：map $uri $placeholder { ~^/avatars/ "/img/avatar-placeholder.png"; ~^/products/ "/img/product-placeholder.jpg"; default "/img/placeholder.png"; }
• 在图片 location 中写：try_files $uri $placeholder;
• 这样 /avatars/123.jpg 缺失时自动返回头像专用占位图，无需多个 location 拆分