centos swagger报错咋办

在 CentOS 上运行 Swagger（如 Swagger UI / Springfox / swagger-ui / FastAPI 等） 报错，原因很多，需要看具体报错信息才能精准定位。下面我按常见场景 + 排查思路给你一个通用解决清单，你对照看看是哪一种。

一、先看报错类型（很重要）

请把完整报错信息贴出来，比如：

404 Not Found
Failed to load API definition
Caused by: java.lang.NoClassDefFoundError
Connection refused
Permission denied

二、常见原因 & 解决办法（CentOS 环境）

1️⃣ 端口没开 / 防火墙拦截（最常见）

CentOS 默认有 firewalld

# 查看防火墙
systemctl status firewalld

# 开放端口（如 8080）
firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --reload

如果是云服务器，还要去安全组放行端口。

2️⃣ Swagger UI 访问 404

常见于：

Spring Boot + Springfox
路径不对

✅ 正确访问地址：

http://IP:端口/swagger-ui.html
或
http://IP:端口/swagger-ui/index.html

✅ 确认依赖：

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
</dependency>

✅ Spring Boot 2.6+ 需要加：

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

3️⃣ Springfox 和 Spring Boot 版本不兼容

常见报错：

org.springframework.context.ApplicationContextException

✅ 推荐组合：

Spring Boot 2.7 → springfox 3.0
Spring Boot 3.x → Springdoc OpenAPI（不要用 springfox）

Springdoc：

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
  <version>2.x</version>
</dependency>

访问：

/swagger-ui/index.html

4️⃣ SELinux 导致无法访问

getenforce

如果是 Enforcing：

setenforce 0

（生产环境不建议长期关闭）

5️⃣ Java / Node 环境异常

检查：

java -version
node -v

如果是：

Java 版本太低
Node 版本不兼容

升级对应运行环境。

6️⃣ 后端没启动 or 接口未暴露

curl http://localhost:8080/v2/api-docs

如果返回 JSON → 后端 OK
如果连不上 → 后端没起 or 配置错误

三、你可以这样给我信息，我直接帮你定位

请告诉我：

✅ CentOS 版本（cat /etc/centos-release）
✅ 用的什么技术（Spring Boot / Node / Python / Nginx）
✅ 完整报错截图或日志
✅ Swagger 访问地址

我可以直接给你针对性解决方案。