Files
xiaoxia-saas/infra/docker/nginx-staging.conf
T
xiaoxia efb9d6c57f
Deploy / Staging E2E Tests (push) Has been cancelled
Deploy / Build Production Runtime Images (push) Has been skipped
Deploy / Deploy Production (push) Has been skipped
Deploy / Production Browser E2E (push) Has been skipped
Deploy / Deploy Staging (push) Failing after 115h22m58s
CI/CD Pipeline / Frontend Lint (push) Failing after 115h23m32s
CI/CD Pipeline / Validate Code Quality And Tests (push) Failing after 115h23m32s
fix: nginx SPA路由移除$uri/,避免/assets等路径被当成静态目录返回403
问题根因:
- try_files $uri $uri/ /index.html 中的 $uri/ 会匹配与构建产物目录同名的路由
- Vite 默认将静态资源放在 assets/ 目录下
- 访问 /assets 时,$uri/ 匹配到 assets/ 目录,Nginx 尝试目录访问返回 403
- 类似的路径冲突还有 /dashboard /history 等如果有同名目录也会出问题

修复方案:
- 移除 $uri/,改为 try_files $uri /index.html
- 真实存在的静态文件(如 /assets/index-abc.js)仍然能通过 $uri 正确返回
- 前端路由路径统一 fallback 到 index.html 由 SPA 路由处理

影响范围:nginx.conf / nginx-production.conf / nginx-staging.conf 三个文件
2026-07-04 17:30:49 +08:00

47 lines
1.4 KiB
Plaintext
Executable File

server {
listen 80;
server_name _;
root /usr/share/nginx/html;
index index.html;
# Gzip compression
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml text/javascript application/javascript application/json application/xml+rss;
client_max_body_size 800m;
# SPA routing - all routes to index.html
# 注意:不能加 $uri/,否则 /assets 等与构建产物目录同名的路由会被当成目录访问,返回 403
location / {
try_files $uri /index.html;
}
# API proxy
# Staging environment: proxy to staging API container on isolated network
resolver 127.0.0.11 valid=10s;
resolver_timeout 5s;
location /api/ {
proxy_pass http://xiaoxia-api-staging:8000/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 300s;
proxy_send_timeout 300s;
proxy_request_buffering off;
}
# Generated files proxy
location /generated-files/ {
alias /app/generated/;
}
# Cache static assets
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}
}