Files
xiaoxia-saas/infra/docker/nginx.conf
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

58 lines
1.9 KiB
Nginx Configuration File
Executable File

# ===========================================
# 小虾剪辑 SaaS — Nginx 配置 (Production 默认)
# ===========================================
#
# 环境隔离说明:
# - staging 使用 nginx-staging.conf → proxy_pass → xiaoxia-api-staging:8000
# - production 使用此文件 → proxy_pass → xiaoxia-api-production:8000
# - 构建时通过 ARG NGINX_CONF 选择配置文件
#
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
# Production environment: proxy to production API container on isolated network
# Use static container name to avoid URI stripping issues with variable-based proxy_pass
resolver 127.0.0.11 valid=10s;
resolver_timeout 5s;
location /api/ {
proxy_pass http://xiaoxia-api-production: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";
}
}