Apache ProxyPass配置问题：SPA邮件下载链接无Auth头致401

要让浏览器直接发起的/api/.../download导航请求返回SPA而非代理到后端，可通过区分请求类型或拦截特定路径实现，以下是两种实用配置方案：

方案一：通过请求头判断是否代理 #

浏览器导航请求与SPA HttpClient发起的API请求存在Accept头差异：前者会发送Accept: text/html，后者通常携带Accept: application/json。基于此修改Apache配置，仅对非HTML请求代理，HTML导航请求直接返回SPA入口：

<Location ~ "^/api/reports.*">
  # 仅当请求非HTML类型时，代理至后端
  ProxyPass "http://reports" connectiontimeout=300 timeout=300 "expr=%{HTTP:Accept} !~ m#text/html#i"
  ProxyPassReverse http://reports
  ProxyPassReverseCookiePath / /reports

  # 针对HTML导航请求，返回SPA入口页面
  RewriteEngine On
  RewriteCond %{HTTP:Accept} text/html [NC]
  RewriteRule ^ /index.html [L]

  <If "%{REQUEST_URI} =~ /download/">
    ProxyErrorOverride on
    ErrorDocument 401 /error-401
  </If>
</Location>

方案二：直接拦截/download导航请求 #

如果仅需处理/download路径的导航请求，可通过前置Rewrite规则或修改ProxyPass条件实现：

方法1：前置Rewrite拦截 #

在<VirtualHost>根配置（原Location块之前）添加规则，提前拦截目标请求并导向SPA：

RewriteEngine On
# 匹配/download路径的HTML导航请求，重定向至SPA入口
RewriteCond %{REQUEST_URI} ^/api/reports/download [NC]
RewriteCond %{HTTP:Accept} text/html [NC]
RewriteRule ^ /index.html [L]

原Location配置无需修改，这类请求会被Rewrite拦截，不会进入代理流程。

方法2：修改ProxyPass条件 #

在原Location块中给ProxyPass添加排除条件，跳过/download的HTML请求：

<Location ~ "^/api/reports.*">
  Require all granted
  # 排除/download路径的HTML请求，其余情况正常代理
  ProxyPass "http://reports" connectiontimeout=300 timeout=300 "expr=%{REQUEST_URI} !~ m#/download#i || %{HTTP:Accept} !~ m#text/html#i"
  ProxyPassReverse http://reports
  ProxyPassReverseCookiePath / /reports

  <If "%{REQUEST_URI} =~ /download/">
    ProxyErrorOverride on
    ErrorDocument 401 /error-401
  </If>
</Location>

原理说明 #

• 浏览器直接点击链接发起的是导航请求，核心需求是获取HTML页面，因此Accept头包含text/html；
• SPA通过HttpClient发起的API请求，Accept头多为application/json等非HTML类型，这类请求会被拦截器自动附加Bearer令牌，可正常代理至后端；
• 上述配置通过区分请求类型，将导航请求导向SPA，待SPA完成认证后，再由前端发起带令牌的下载请求。

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