VS Code Python HTTP触发器多参数测试URL构造及JSON报错排查

代码报错排查 #

编辑于美国东部标准时间12月1日16:21：我已缩小问题范围，以下Python3代码可以正常运行：

ptc = req.params.get('name')
assets = req.params.get('assets')
if not ptc:
    try:
        req_body = req.get_json()
    except ValueError:
        pass
    else:
        ptc = req_body.get('name')
        assets = req_body.get('assets')

if ptc:
    return func.HttpResponse(f"Hello boogerface, {ptc}, {assets}. This HTTP triggered function executed successfully.")
else:
    return func.HttpResponse(
         "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.",
         status_code=200
    )

当我移除条件判断和try except语句，将代码修改为如下Python3版本时：

ptc = req.params.get('name')
assets = req.params.get('assets')
req_body = req.get_json()
ptc = req_body.get('name')
assets = req_body.get('assets')  
return func.HttpResponse(f"Hello, {ptc}, {assets}. This HTTP triggered function executed successfully.")

运行报错，浏览器返回HTTP 500状态码，错误信息为：

HTTP request does not contain valid JSON data

请问为什么第二段代码无法运行？我原本认为移除分支判断不会影响运行效果，预期成功运行后浏览器会显示如下内容：

核心需求 #

我在Visual Studio Code（VSC）中用Python编写了一个HTTP触发器，想要构造本地测试URL直接在浏览器中调用接口，不需要在代码中生成URL。

*目前已完成的操作：*在VSC内运行函数时，传入JSON字符串例如{"var1":"value1","var2":"value2"}，只要参数和代码变量匹配，不管多少个参数都能正常运行。

但在浏览器中调用时情况不同：
URL中只传1个参数时，比如示例地址（非真实地址）：

http://localhosturl/thisapi?var1=OHMYGOSH

不加引号也不做编码，接口返回HttpResponse正常，浏览器能正确显示参数值，当前返回值仅作为调试用途。

但当URL中传入超过1个参数时，例如：

http://localhosturl/thisapi?var1=OHMYGOSH&var2=THISISCRAZY

浏览器返回localhost HTTP ERROR 500，终端报错信息为：

HTTP request does not contain valid JSON data

**我的核心问题是：带参数的URL中JSON字符串应该是什么格式？**我已经尝试/调研了以下方案：

• URL编码，格式为?"URL编码后的字符串"
• Base64编码，格式为?"Base64编码后的字符串"
• 用req作为参数名传入，格式为?req="URL或Base64编码后的字符串"
• 直接拼接参数如上方示例URL
• 在代码中动态生成URL的方案（不符合需求，不需要这类方案）

我目前仅想要构造一个可传入多参数的URL，让接口能在浏览器中正常调用。该需求的背景是：后续部署到服务器后，我需要用另一个脚本构造URL调用接口，获取计算后的返回值，因此需要明确可正常调用的URL格式。

第二段代码报错的原因 #

浏览器直接发起的GET请求默认没有请求体，更不会携带JSON格式的请求数据。
第一段代码的逻辑为：优先从URL查询参数中取值，只有查询参数取不到对应值时，才会尝试解析请求体的JSON，且解析过程套了try-except捕获异常，即使请求没有合法JSON也不会中断运行。
第二段代码删除了所有判断逻辑，强制调用req.get_json()解析请求体，只要请求没有合法JSON就会直接抛出ValueError，触发500错误，和URL传了多少个参数没有关联。你之前单参数测试正常是因为当时使用的是未修改的第一段代码，若用第二段代码测试，哪怕URL只传1个参数也会报错。

多参数URL构造方案 #

浏览器直接输入URL发起的是GET请求，参数放在URL的查询字符串中即可，不需要在URL中塞入JSON字符串，符合要求的URL格式如下：

http://你的接口地址?参数1=值1&参数2=值2&参数3=值3

对应代码不需要强制解析JSON，直接从req.params中取值即可，示例代码：

# 直接从URL查询参数取所有需要的参数即可
var1 = req.params.get('var1')
var2 = req.params.get('var2')
# 更多参数同理添加即可
return func.HttpResponse(f"Hello, {var1}, {var2}. 调用成功")

如果你需要同时兼容JSON请求体传参和URL查询参数传参，只要保留原始代码的try-except逻辑即可，不要删除异常捕获和判断分支。

如果你确实需要在URL中传递JSON字符串（不推荐，效率低于直接拼接参数），可以将JSON字符串做URL编码后作为单个参数的值传递，示例：

1. 原始JSON：{"var1":"OHMYGOSH","var2":"THISISCRAZY"}
2. URL编码后：%7B%22var1%22%3A%22OHMYGOSH%22%2C%22var2%22%3A%22THISISCRAZY%22%7D
3. 拼接后的URL：http://你的接口地址?json=%7B%22var1%22%3A%22OHMYGOSH%22%2C%22var2%22%3A%22THISISCRAZY%22%7D
4. 代码中先取参数再解析：

import json
json_str = req.params.get('json')
req_data = json.loads(json_str)
var1 = req_data.get('var1')
var2 = req_data.get('var2')

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