apache默认只从documentroot查找文件，访问其外部资源必404；解决需显式映射：用alias指令挂载或创建软链接并启用followsymlinks，同时确保权限与selinux上下文正确。

Apache 把静态资源放在 DocumentRoot 目录外就 404，根本原因很直接：Apache 默认只从 DocumentRoot 开始查找文件，不会自动访问其外部路径。它不是“找不到文件”，而是压根没被允许去那个地方找。

要解决，核心思路就两个：要么把资源挪进去，要么让 Apache “看得见”外面的目录。下面分情况说清楚：

DocumentRoot 外的资源必须被显式映射

Apache 不像开发服务器（如 Vite、Webpack Dev Server）会自动解析别名或模块路径。所有 HTTP 请求路径（比如 /assets/logo.png）都必须能映射到一个物理位置，且该位置需在 Apache 的访问控制范围内。

常见错误场景：

• 把图片放在 /var/www/shared/images/，但 DocumentRoot 是 /var/www/site/
• 前端构建后输出到 /opt/build/static/，却没告诉 Apache 这个路径可访问

修复方法（选其一）：

• ✅ 用 Alias 指令挂载外部目录
  在虚拟主机配置或主配置中添加：

  Alias /assets "/var/www/shared/images"
  <directory>
      Require all granted
      Options Indexes FollowSymLinks
  </directory>

  这样访问 /assets/logo.png 就会真实读取 /var/www/shared/images/logo.png

• ✅ 用符号链接（软链接）并启用 FollowSymLinks
  在 DocumentRoot 内创建指向外部目录的软链：

  ln -s /var/www/shared/images /var/www/site/assets

  然后确保 <directory></directory> 块中有：

  

  Apache Superset Dashboard and SQL Exploration Skill

  Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

  下载

  Options FollowSymLinks
  Require all granted

• ❌ 不推荐：改 DocumentRoot 指向父目录（如 /var/www）
  安全风险高，可能暴露不该公开的配置、日志或脚本目录。

路径大小写和拼写必须严格匹配

Linux 文件系统区分大小写，而浏览器 URL 也原样传递。比如：

• 服务器上是 /var/www/site/CSS/main.css
• HTML 中写的是 <link href="/css/main.css"> → 404
• 或者文件名是 logo.PNG，但引用的是 logo.png → 同样 404

建议统一用小写命名，检查 ls -l 输出与 HTML 中的 src/href 是否逐字符一致。

确保外部目录有正确权限和 SELinux 上下文（CentOS/RHEL）

即使路径映射对了，Apache 进程（如 apache 或 www-data 用户）仍可能无权读取外部目录：

• 检查权限：

  ls -ld /var/www/shared/images
  # 应至少有 r-x（目录）和 r（文件）
  sudo chown -R apache:apache /var/www/shared/images
  sudo chmod -R 755 /var/www/shared/images

• CentOS 上若启用了 SELinux，还需打标签：

  sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/shared/images(/.*)?"
  sudo restorecon -Rv /var/www/shared/images

验证是否生效的小技巧

• 直接用 curl -I http://yoursite/assets/logo.png 看状态码和 Content-Length
• 查看 Apache 错误日志（/var/log/httpd/error_log），搜索 File does not exist 后面的真实路径，确认 Apache 实际尝试读取的是哪一段
• 如果日志里出现 AH00037: Symbolic link not allowed，说明 FollowSymLinks 没开或被 SymLinksIfOwnerMatch 限制了

不复杂但容易忽略。