Nginx配置求助：为Google Bot返回预渲染HTML而非代理Angular应用

原配置的核心问题 #

1. 语法错误：判断User-Agent的if语句末尾写错了，应该是;)而不是>，这会直接导致Nginx配置失效
2. 文件返回逻辑错误：用rewrite ^ $static_file会触发Nginx重新匹配location，而非直接返回文件，容易引发404/403
3. 权限/路径问题：403通常是Nginx进程没有读取预渲染文件的权限，404可能是$static_file路径拼接错误

修正后的完整配置 #

location / {
    # 标记是否为爬虫（可自行添加其他UA关键词）
    set $isBot 0;
    if ($http_user_agent ~* "googlebot") {
        set $isBot 1;
    }

    # 定义预渲染文件路径
    set $static_file /var/www/main/static$uri/index.html;

    # 仅当是爬虫且文件存在时，返回静态预渲染文件
    if ($isBot = 1) {
        if (-f $static_file) {
            root /;
            rewrite ^ /var/www/main/static$uri/index.html break;
        }
    }

    # 其他情况代理到Angular SPA
    proxy_pass http://localhost:4200;
    proxy_http_version 1.1;
    proxy_buffering off;
    proxy_connect_timeout 60s;
    proxy_read_timeout 5400s;
    proxy_send_timeout 5400s;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_cache_bypass $http_upgrade;
}

关键调整说明 #

• 修复if语句语法错误，确保配置能正常加载
• 用root /配合rewrite ... break直接返回文件，避免location重匹配
• 调整逻辑顺序：先判断是否为爬虫，再检查文件是否存在，减少不必要的文件检查
• 若觉得嵌套if不够优雅，可改用变量组合的方式（更符合Nginx最佳实践）：

location / {
    set $isBot 0;
    if ($http_user_agent ~* "googlebot") {
        set $isBot 1;
    }

    set $static_file /var/www/main/static$uri/index.html;
    set $action "proxy";

    # 当是爬虫时标记为待检查静态文件
    if ($isBot = 1) {
        set $action "static";
    }
    # 若文件不存在则改回代理逻辑
    if (!-f $static_file) {
        set $action "${action}_proxy";
    }

    if ($action = "static") {
        root /;
        rewrite ^ /var/www/main/static$uri/index.html break;
    }

    # 代理逻辑不变
    proxy_pass http://localhost:4200;
    # ... 其他proxy配置
}

必做的权限检查 #

• 确保Nginx运行用户（通常是www-data）对/var/www/main/static目录及子文件有读权限
• 目录权限设置为755，文件权限设置为644，可执行以下命令：

chown -R www-data:www-data /var/www/main/static
chmod -R 755 /var/www/main/static
find /var/www/main/static -type f -exec chmod 644 {} \;

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