Azure Functions函数可运行但默认URL返回500错误的排查与解决

问题描述 #

本地测试Python HTTP触发函数时返回200 OK正常响应，但部署到Azure后访问默认URL dm-weu-functionapp1.azurewebsites.net 出现HTTP ERROR 500，页面无法加载。

原代码 #

import logging
import azure.functions as func

def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')
    document = ["Bestuur","Cultuur en recreatie","Economie"]
    logging.info('Python HTTP trigger function defined the document.')
    req_body = req.get_json()
    document = req_body if req_body else document
    # if req_body:
    #     document.update(req_body)
    # logging.info(f"Document: {document}")
    
    if document:
        return func.HttpResponse(f"Hello, {document}. This HTTP triggered function executed successfully.")
    else:
        return func.HttpResponse(
             "This HTTP triggered function executed successfully. Pass a document in the query string or in the request body for a personalized response.",
             status_code=200
        )

原因分析 #

• 无请求体时的解析异常：直接访问默认URL发送的是GET请求，没有JSON格式的请求体，但代码未做判断就调用req.get_json()，该方法在无JSON请求体时会抛出ValueError，触发函数500错误。本地测试可能仅覆盖了带JSON请求体的场景，未测试无请求体的GET请求，因此未暴露问题。
• 日志缺失：代码注释掉了关键日志打印，无法通过Azure函数日志快速定位错误原因。

解决方案 #

1. 异常捕获与多源数据适配 #

修改代码，捕获请求体解析异常，同时支持从查询参数获取数据，适配GET请求场景：

import logging
import azure.functions as func

def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')
    document = ["Bestuur","Cultuur en recreatie","Economie"]
    logging.info('Python HTTP trigger function defined the document.')
    
    # 优先处理请求体，捕获无JSON的情况
    try:
        req_body = req.get_json()
        if req_body:
            document = req_body
    except ValueError:
        # 无请求体时尝试从查询参数读取
        doc_param = req.params.get('document')
        if doc_param:
            # 支持逗号分隔的多个值
            document = doc_param.split(',')
    
    logging.info(f"Document: {document}")
    
    if document:
        return func.HttpResponse(f"Hello, {document}. This HTTP triggered function executed successfully.")
    else:
        return func.HttpResponse(
             "This HTTP triggered function executed successfully. Pass a document in the query string or in the request body for a personalized response.",
             status_code=200
        )

2. 日志排查 #

取消注释原代码中的日志语句，或添加更多关键日志，然后登录Azure门户：

• 进入对应的Function App，点击监控->日志
• 查看函数执行的错误堆栈，确认具体异常信息（若仍有问题）

3. 测试验证 #

• 直接访问默认URL（GET请求），验证是否返回正常响应
• 用Postman发送带JSON请求体的POST请求，确认个性化响应正常
• 测试查询参数场景，例如访问 dm-weu-functionapp1.azurewebsites.net/api/YourFunctionName?document=Test1,Test2，验证参数解析正常

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