Nuxt设置subFolders:false后查询字符串含点无法路由问题求助

问题根因 #

你遇到的报错本质是subFolders: false配置的副作用：该配置会让Nuxt生成静态资源时直接输出enroll.html而非enroll/index.html，当路径带尾部斜杠且查询参数含点时，Nuxt的路由匹配逻辑会把该路径识别为静态文件夹路径，找不到对应资源就返回Cannot GET错误。

方案1（优先推荐）：改用Nuxt原生路由斜杠配置 #

放弃用subFolders控制尾部斜杠逻辑，改用专门的路由配置，完全规避该问题，改动最小：

1. 删掉nuxt.config.js中原来的generate.subFolders: false配置
2. 新增路由配置项：

// nuxt.config.js
export default {
  router: {
    trailingSlash: false // 全局关闭自动追加尾部斜杠，不会触发不必要的301，也不影响带点的查询参数
  }
}

该配置专门处理路由末尾斜杠逻辑，优先级高于subFolders，适配所有路由场景，不管页面是否有子页面都不会强制追加斜杠。

方案2：若必须保留subFolders: false配置，新增Nginx重写规则 #

如果因历史逻辑需要保留原有配置，在Nginx配置中新增路径匹配规则，将带尾部斜杠且查询参数含点的请求重定向到无斜杠路径即可：

# 在原有location /块之前新增该规则
location ~ ^/([a-zA-Z0-9_-]+)/$ {
    # 当查询参数含点时，重定向到去掉尾部斜杠的路径，保留完整查询参数
    if ($args ~* "\.") {
        return 301 /$1$is_args$args;
    }
    # 其余逻辑和原有location /块保持完全一致即可
    expires                             $expires;
    proxy_redirect                      off;
    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                  1m;
    proxy_connect_timeout               1m;
    proxy_pass                          http://127.0.0.1:3000;
    auth_basic                          "Restricted Content";
    auth_basic_user_file                /etc/nginx/.htpasswd;
}

修改后重载Nginx配置即可生效，原有其他路由逻辑不受影响。

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