Android设备调用Magento 2 API返回404错误求助

问题背景 #

我开发的Ionic应用在Android设备上调用Magento 2网站的多数API时，一直返回404错误，但用ionic serve本地调试或者Postman测试这些API完全正常。下面是我的相关配置和排查过程：

相关配置信息 #

ionic.config.json

{ 
  "name": "appname", 
  "app_id": "f82ad91b", 
  "integrations": { "cordova": {} }, 
  "type": "ionic-angular", 
  "proxies": [ 
    { 
      "path": "/api", 
      "proxyUrl": "https://{url}/index.php/rest/V1" 
    } 
  ] 
}

服务提供者代码（providers/foo/bar.ts）

private apiUrl:string; 
/** 
 * @public 
 * @constructor 
 */ 
constructor( 
  public http: HttpClient, 
  public platform: Platform, 
  public storage: Storage, 
  private authProvider: AuthenticateProvider, 
  private catalogProvider: CatalogProvider) { 
    if(this.platform.is('core') || this.platform.is('mobileweb')){ 
      this.apiUrl = '/api'; 
    } else { 
      this.apiUrl = 'https://{url}/index.php/rest/V1'; 
    } 
}

config.xml

<access origin="*" /> 
<allow-intent href="http://*/*" /> 
<allow-intent href="https://*/*" /> 
<allow-intent href="tel:*" /> 
<allow-intent href="sms:*" /> 
<allow-intent href="mailto:*" /> 
<allow-intent href="geo:*" /> 
<plugin name="cordova-plugin-whitelist" spec="^1.3.3" />

排查更新记录 #

• 2018-05-23：发现404错误返回的是类似503错误页面的HTML响应；通过Chrome调试工具看到错误响应头包含content-security-policy: upgrade-insecure-requests，但请求和服务端明明都用了HTTPS，这点暂时搞不懂原因。
• 2018-05-24：iOS版本用UIWebView能正常运行（这个细节和当前Android问题无关）；在index.html里加了CSP标签后，Android的问题还是没解决。

可能的原因及解决方案 #

1. 域名解析或CDN缓存搞鬼

虽然用了HTTPS，但Android设备可能遇到域名解析异常，或者CDN返回了错误的缓存页面（比如之前的503静态页面）。

• 解决办法：
  • 切换Android设备的网络（比如从WiFi切到移动数据）测试，排除本地DNS缓存的问题；
  • 直接用Magento服务器的IP地址替换域名请求，确认是不是域名解析的锅；
  • 联系服务器管理员，检查CDN缓存规则，清一下相关路径的缓存。

2. Cordova WebView的User-Agent被拦截

Magento 2可能对请求的User-Agent有过滤，Android Cordova默认的UA可能被服务器判定为异常请求，直接返回404。

• 解决办法：
  • 自定义Cordova WebView的User-Agent，模拟Postman或者桌面浏览器的UA；
  • 代码示例（在app.component.ts的platform.ready()里加）：

    platform.ready().then(() => {
      if (this.platform.is('android')) {
        (window as any).plugins.webview.changeUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36');
      }
    });
    

  • 同时去Magento 2的服务器日志里看看，确认请求的UA是不是被拦截了。

3. HTTPS证书信任问题

Android设备可能不信任Magento服务器的SSL证书，导致请求被拦截，返回的404其实是证书验证失败的伪装。

• 解决办法：
  • 确认服务器的SSL证书是正规CA颁发的，不是自签名的；如果是自签名证书，要么给Android设备安装该证书，要么在Cordova里配置信任自签名证书；
  • 用cordova-plugin-advanced-http替代原生HttpClient，这个插件支持自定义证书信任：

    import { HTTP } from '@ionic-native/http/ngx';
    
    constructor(private http: HTTP) {}
    
    // 请求示例
    this.http.get('https://{url}/index.php/rest/V1/your-api', {}, {})
      .then(data => {
        console.log(data.data);
      })
      .catch(error => {
        console.log(error.status);
      });
    

4. Magento 2 API路由匹配问题

虽然Postman能正常调用，但Android设备的请求可能因为参数编码、路由格式问题，导致Magento匹配不到正确的API端点。

• 解决办法：
  • 对比Postman和Android请求的完整URL、请求头、参数编码，确保完全一致；
  • 去Magento 2的var/log/debug.log里查看请求详情，确认服务器有没有接收到正确的请求路径；
  • 检查Magento 2的API权限，确保应用使用的Token有足够的访问权限。

5. 补充CSP和Whitelist配置

虽然已经加了CSP标签和Whitelist，但可能有遗漏的配置：

• 解决办法：
  • 在config.xml里添加<allow-navigation href="https://{url}/*" />，明确允许导航到Magento域名；
  • 调整CSP标签，确保允许从Magento域名加载资源，比如：

    <meta http-equiv="Content-Security-Policy" content="default-src 'self' https://{url} data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *; img-src 'self' data: content:;">
    

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