在 linux 中，nginx 通过 server_name 匹配域名并将请求路由到对应的 location 块，利用 try_files 按优先级查找文件，从而实现多租户的静态资源隔离。具体做法是在每个租户的 location 中设置根目录为租户专属文件夹，并配置 try_files $uri $uri/ /index.html;，这样 nginx 会先尝试返回请求的文件，若不存在则回退到默认入口，确保 spa 应用或静态站点在多租户环境下正确加载。
server_name 如何区分不同租户域名
server_name 指令用于匹配 HTTP 请求头中的 Host 字段，将流量分发到不同的虚拟主机配置。在多租户场景中，通常每个租户拥有独立的子域名（如 tenant1.example.com），Nginx 根据这些域名创建独立的 server 块。当请求到达时，Nginx 会选择最匹配的 server 块处理请求，从而进入该租户的配置上下文。这种机制允许为不同租户提供完全独立的配置逻辑，包括不同的根目录、SSL 证书和缓存策略。
server {
listen 80;
server_name tenant1.example.com;
root /var/www/tenants/tenant1;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
上述配置针对 tenant1.example.com，其根目录指向 /var/www/tenants/tenant1。当用户访问 http://tenant1.example.com/style.css 时，Nginx 会在 /var/www/tenants/tenant1/style.css 查找文件。如果找到，直接返回；如果未找到，则继续尝试目录索引或回退到 /index.html。这种结构确保了每个租户的资源互不干扰。
try_files 在多租户 SPA 中的应用逻辑
try_files 指令按顺序检查文件是否存在，一旦找到第一个存在的文件或目录，就立即返回该内容，不再检查后续项。对于单页应用（SPA），前端路由由 JavaScript 处理，服务器端需要将所有非静态资源的请求重定向到 index.html，以便前端路由器接管。在多租户环境中，这一逻辑需要在每个租户的 location 块中独立配置，确保回退行为仅在当前租户的上下文中生效。
server {
listen 80;
server_name tenant2.example.com;
root /var/www/tenants/tenant2;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location ~* \.(js|css|png|jpg)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
}
在 tenant2 的配置中，try_files 首先检查 $uri（精确文件路径），然后检查 $uri/（目录索引），最后回退到 /index.html。对于静态资源（JS、CSS、图片），通过额外的 location 块启用长期缓存，提升加载性能。这种分离确保了动态请求和静态资源的高效处理，同时保持了多租户配置的清晰性。
基于 try_files 回退到 /index.html 的具体问题
当使用 try_files $uri $uri/ /index.html; 时，如果请求的路径是 /app（无斜杠），Nginx 会先检查 /app 是否为文件，再检查 /app/ 是否为目录。如果两者都不存在，它会将内部重定向到 /index.html。这意味着前端路由必须能够处理根路径 / 的请求。如果前端应用期望在 /app 路径下运行，而服务器配置未正确处理，可能导致白屏或 404 错误。解决此问题的关键是确保前端应用的基路径（base href）与服务器回退路径一致，或者在 try_files 中显式指定回退路径，如 /app/index.html，以匹配前端的预期。
