如何在WSO2中通过带别名与值的GET API向外部链接发起POST请求？

一、错误原因分析 #

你遇到的两个错误均属于配置问题，与代码逻辑无关：

• 405 Method Not Allowed：API资源的HTTP方法与请求不匹配，或网关路由未正确映射，也可能是CORS预检请求被拦截。
• Failed to fetch：网关仅绑定localhost导致外部无法访问，或跨域请求被浏览器拦截，也可能是服务器端口未开放。

二、分步排查与修复 #

1. 解决405 Method Not Allowed错误 #

• 检查API资源配置：
  进入Publisher的API编辑页面，确认资源的HTTP方法为GET，且查询参数alias、value已正确添加。测试时确保使用GET方法发起请求，避免误发POST。
• 查看网关路由日志：
  查看WSO2 APIM网关的wso2carbon.log（默认路径：<APIM_HOME>/repository/logs/），搜索Method Not Allowed相关条目，确认路由是否正确匹配GET资源。
• 配置CORS规则：
  如果是浏览器端发起请求，405可能与CORS预检请求有关。在APIM的deployment.toml中添加以下配置，允许对应Origin和GET方法：

  [apim.gateway.cors]
  enable = true
  allow_origins = ["*"] # 根据实际需求替换为具体域名
  allow_methods = ["GET", "POST", "OPTIONS"]
  allow_headers = ["Authorization", "Content-Type"]
  

2. 解决Failed to fetch错误 #

• 修改网关监听配置：
  由于服务器部署在自有机器但网关选择localhost，导致网关仅监听本地回环接口。修改deployment.toml中的传输配置，让网关监听服务器IP或所有接口：

  [transport.http]
  listener.hostname = "0.0.0.0" # 或服务器的内网/公网IP
  listener.port = 8280
  
  [transport.https]
  listener.hostname = "0.0.0.0" # 或服务器的内网/公网IP
  listener.port = 8243
  

  重启WSO2 APIM服务后，使用服务器IP访问API。
• 检查端口与防火墙：
  确认服务器的8280（HTTP）、8243（HTTPS）端口已对外开放，防火墙规则允许外部请求进入。
• 处理跨域问题：
  如果在本地浏览器访问服务器上的DevPortal，需确保APIM的CORS配置允许当前浏览器的Origin（参考上述CORS配置）。

三、代码修正建议 #

你提供的代码存在两处关键问题，即使配置正确也无法正常运行：

1. 未定义username变量：需添加var username = 'your_username';替换占位符。
2. Node.jsBuffer不兼容：WSO2 Synapse的Nashorn引擎不支持Node.js的Buffer，需改用Java的Base64编码实现。

修正后的代码：

var username = 'your_username';
var password = 'your_password';
var externalUrl = 'https://your_external_url';

var value = mc.getProperty('query.param.value');
var alias = mc.getProperty('query.param.alias');

if (!value || !alias) {
    mc.setProperty('HTTP_SC', '400');
    mc.setPayloadJSON({ error: 'Both value and alias are required.' });
} else {
    // 构造请求Payload
    var payload = JSON.stringify({ value: value, alias: alias });

    // 设置Basic Auth及请求头
    var headers = {};
    headers['Authorization'] = 'Basic ' + getBase64EncodedCredentials(username, password);
    headers['Content-Type'] = 'application/json';

    // 使用Synapse标准方式发起外部POST请求
    var endpoint = new Packages.org.apache.synapse.endpoints.HTTPEndpoint();
    endpoint.setURI(externalUrl);
    
    var callMediator = new Packages.org.apache.synapse.mediators.builtin.CallMediator();
    callMediator.setEndpoint(endpoint);
    callMediator.setBlocking(true);
    
    // 配置请求方法、Payload和头信息
    mc.setProperty("HTTP_METHOD", "POST");
    mc.setPayloadJSON(JSON.parse(payload));
    for (var key in headers) {
        mc.setProperty("HTTP_HEADER_" + key, headers[key]);
    }
    
    callMediator.mediate(mc);
}

// 基于Java实现Base64编码
function getBase64EncodedCredentials(username, password) {
    var creds = username + ':' + password;
    var bytes = new Packages.java.lang.String(creds).getBytes(Packages.java.nio.charset.StandardCharsets.UTF_8);
    return Packages.java.util.Base64.getEncoder().encodeToString(bytes);
}

另外，不建议使用Mock实现：Mock模式主要用于返回模拟数据，不适合发起外部请求。应选择Endpoint实现类型，在In Sequence中添加上述Script Mediator处理参数转发。

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