部署含双函数的Azure Function ARM模板时遇InternalServerError

模板中的明确错误 #

先看你提供的ARM模板函数定义，存在几个明显问题：

1. HTTP触发器结构错误 #

第一个HTTP触发器的配置直接将methods、route、authLevel等属性放在properties根节点下，这不符合ARM模板定义Function触发器的规范。正确的做法是将这些配置放在bindings数组内的HTTP触发器绑定中。

错误写法（你的模板）：

"properties": {
    "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-http-',parameters('environment'))]",
    "scriptFile": "[concat('site/wwwroot/httpTrigger/run.ps1')]",
    "route": "api/{req?}",
    "methods": [
        "GET",
        "POST"
    ],
    "authLevel": "anonymous",
    "direction": "in"
}

2. 定时器触发器的多个问题 #

• 名称不匹配：外层name是[concat(parameters('functionApp'),'/',parameters('project'),'-timerTrigger-',parameters('environment'))]，但properties.name却是[concat(parameters('functionApp'),'/',parameters('project'),'-timer-',parameters('environment'))]，两者必须完全一致。
• 空schedule：定时器触发器的schedule字段不能为空，必须提供合法的CRON表达式（比如"0 */5 * * * *"表示每5分钟执行一次）或固定间隔字符串。
• timeout格式错误：timeout字段需要是timespan格式（比如"00:00:30"），而非单纯的数字字符串"30"。

错误写法（你的模板定时器部分）：

"properties": {
    "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-timer-',parameters('environment'))]",
    "scriptFile": "[concat('site/wwwroot/timer/run.ps1')]",
    "timeout": "30",
    "bindings": [
        {
            "name": "myTimer",
            "type": "timerTrigger",
            "direction": "in",
            "schedule": ""
        }
    ]
}

修正后的模板示例 #

HTTP触发器修正后 #

{
    "type": "Microsoft.Web/sites/functions",
    "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-http-',parameters('environment'))]",
    "apiVersion": "2018-11-01",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('functionApp'))]"
    ],
    "properties": {
        "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-http-',parameters('environment'))]",
        "scriptFile": "[concat('site/wwwroot/httpTrigger/run.ps1')]",
        "bindings": [
            {
                "name": "req",
                "type": "httpTrigger",
                "direction": "in",
                "route": "api/{req?}",
                "methods": [
                    "GET",
                    "POST"
                ],
                "authLevel": "anonymous"
            },
            {
                "name": "$return",
                "type": "http",
                "direction": "out"
            }
        ]
    }
}

定时器触发器修正后 #

{
    "type": "Microsoft.Web/sites/functions",
    "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-timerTrigger-',parameters('environment'))]",
    "apiVersion": "2018-11-01",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[resourceId('Microsoft.Web/sites', parameters('functionApp'))]"
    ],
    "properties": {
        "name": "[concat(parameters('functionApp'),'/',parameters('project'),'-timerTrigger-',parameters('environment'))]",
        "scriptFile": "[concat('site/wwwroot/timer/run.ps1')]",
        "timeout": "00:00:30",
        "bindings": [
            {
                "name": "myTimer",
                "type": "timerTrigger",
                "direction": "in",
                "schedule": "0 */5 * * * *"
            }
        ]
    }
}

额外调试步骤 #

如果修正模板后仍报错，执行以下操作排查：

• 检查Function App的存储账户连接字符串是否正确配置：Function App依赖存储账户进行触发器调度、日志存储等，连接字符串错误会导致运行时异常。
• 查看Function App的详细运行日志：
  1. 进入Azure门户的Function App资源，打开“平台功能”>“日志流”，实时查看主机运行时的详细错误信息。
  2. 登录Kudu控制台，查看D:\home\LogFiles\Application\Functions\Host下的日志文件，里面会有更具体的错误堆栈。
• 确认部署的函数代码（run.ps1）是否存在语法错误或依赖缺失：可以在本地测试代码后再部署。

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