编译WSO2 APIM代码时swagger.yaml 404错误的解决咨询

核心排查与修复步骤 #

这个404错误是前端Devportal应用无法从后端获取swagger配置文件导致的，按以下步骤逐一排查：

1. 确保后端APIM服务正常运行 #

• apim-apps是前端应用，必须依赖WSO2 API Manager后端服务才能正常工作，先启动WSO2 APIM后端服务器，不能只编译前端。
• 直接在浏览器访问http://localhost:8084/api/am/devportal/v3/swagger.yaml，如果仍返回404，说明后端未正确部署该接口，优先排查后端服务状态。

2. 核对前端配置的后端API地址 #

• 进入前端项目的devportal/src/environments/目录，打开environment.ts（开发环境）或environment.prod.ts（生产环境），检查apiManager的baseUrl配置，确保和后端服务的端口、路径完全匹配。
  • 示例正确配置（假设后端在8084端口）：

    apiManager: {
      baseUrl: 'http://localhost:8084/api/am/devportal/v3'
    }
    

• 修改配置后，重新执行编译命令：npm run build（或项目指定的编译命令）

3. 检查后端Devportal API的配置与状态 #

• 登录WSO2 APIM管理控制台（默认地址https://localhost:9443/carbon），确认Devportal相关API已发布并启用。
• 打开后端的repository/conf/deployment.toml文件，验证Devportal API的上下文路径配置：

  [apim.devportal]
  api_context = "/api/am/devportal/v3"
  

• 若配置有误，修改后重启后端服务。

4. 验证本地开发代理配置（开发环境） #

• 如果是用npm start运行的本地开发环境，检查项目根目录的proxy.conf.json（或类似代理配置文件），确认是否将前端请求代理到后端：

  {
    "/api/am/devportal/v3/*": {
      "target": "http://localhost:8084",
      "secure": false,
      "changeOrigin": true
    }
  }
  

• 代理配置错误会导致请求无法转发，修改后重启前端服务。

5. 查看后端日志定位深层问题 #

• 打开后端的repository/logs/wso2carbon.log日志文件，搜索swagger.yaml相关请求记录，查看是否有权限报错、接口加载失败等信息，进一步定位问题根源。

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