Python调用Qlik Catalog PUT接口报「PUT方法不被支持」问题求助

问题原因 #

405错误表示当前请求路径不支持你使用的PUT方法，结合给出的场景，大概率是以下几个原因（按出现概率从高到低排序）：

1. 路径参数/查询参数混淆：你路径末尾的true大概率是查询参数而非路径参数，误将其拼接到路径中会导致请求的是服务端根本不存在的路径，该路径自然没有开放PUT方法。
2. 重定向导致请求方法被篡改：requests的session默认开启自动重定向，当服务端返回301/302重定向响应时，会自动将PUT请求改为GET请求访问重定向地址，触发目标地址不支持GET方法的405报错。常见触发场景包括：路径少了/多了末尾斜杠、HTTP协议被重定向到HTTPS、路径拼写错误触发跳转。
3. 路径拼写/大小写错误：和服务端实际暴露的接口路径不一致，对应路径没有开放PUT方法。

解决步骤 #

按顺序排查即可：

1. 核对接口路径定义：回到Swagger页面确认true的参数类型，如果是查询参数，调整路径写法：

   url_stem = 'http://xxxxnnnnnn.xxxxxxx.xxxx.xxx:nnnn/qdc/entity/v1/loadDataForEntities'
   # 把true放到查询参数中，xxx替换为Swagger里定义的参数名
   response = session.put(url_stem, json=payload, headers=headers, params={"xxx": "true"})
   

   同时核对路径的拼写、大小写、是否有多余/缺少的末尾斜杠。
2. 关闭自动重定向排查跳转问题：修改请求代码关闭自动重定向，确认是否存在跳转：

   response = session.put(url_stem, json=payload, headers=headers, allow_redirects=False)
   

   如果返回301/302状态码，直接取响应头Location字段的地址作为新的请求地址发起请求即可。
3. 核对请求协议：如果Swagger页面用的是HTTPS协议，把代码里URL开头的http改成https，避免协议跳转导致的请求方法变更。
4. 对比请求差异：安装curlify库打印实际发起的请求curl命令，和Swagger的正常请求做对比，可快速定位差异：

   import curlify
   # 发送请求后执行即可打印实际请求的curl命令
   print(curlify.to_curl(response.request))
   

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