You need to enable JavaScript to run this app. Nginx反向代理SpringBoot接口带/live/api前缀返回404如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Nginx反向代理SpringBoot接口带/live/api前缀返回404如何解决

404错误根因

当前Nginx的反向代理配置会完整保留原请求的路径前缀/live/api,转发到SpringBoot服务的实际请求路径为/live/api/auth/login,而你的SpringBoot项目没有配置/live/api作为全局接口前缀,接口仅匹配/auth/login路径,因此无法找到对应资源返回404。Spring后台日志中打印的POST "/live/api/auth/login"也印证了请求路径和接口路径不匹配的问题。

可选解决方案

方案1:修改Nginx配置(侵入性最小,推荐)

在proxy_pass的目标地址末尾添加斜杠/,Nginx会自动抹除匹配到的/live/api前缀后再转发请求:

location /live/api {
    # 末尾的/会触发Nginx路径替换,自动去掉/live/api前缀
    proxy_pass http://localhost:8081/;

    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-Host   $host;
    proxy_set_header    X-Forwarded-Server $host;
    proxy_set_header    X-Forwarded-Port   $server_port;
    proxy_set_header    X-Forwarded-Proto  $scheme;
}

修改后请求/live/api/auth/login会被转发到http://localhost:8081/auth/login,和SpringBoot的接口路径完全匹配。

方案2:配置SpringBoot全局路径前缀

如果不想修改Nginx配置,可以给SpringBoot项目统一添加/live/api全局路径前缀:
在application.yml中添加如下配置:

server:
  servlet:
    context-path: /live/api

如果使用application.properties则添加:

server.servlet.context-path=/live/api

配置完成后所有SpringBoot接口都会自动带上/live/api前缀,和Nginx转发的路径匹配。

方案3:手动修改接口和权限规则

如果不希望调整全局配置,也可以手动给所有接口的@RequestMapping加上/live/api前缀,同时同步修改SecurityConfig的权限匹配规则:

// Set permissions on endpoints
http.authorizeRequests()
        // 权限规则同步添加/live/api前缀
        .antMatchers("/live/api/auth/**").permitAll()
        .antMatchers("/live/api/public/**").permitAll()
        .anyRequest().authenticated();

内容的提问来源于stack exchange,提问作者Nisuga Jayawardana

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 23:48:01