Azure Function App的GET/POST请求报500内部错误，求调试解决建议

一、核心问题排查与修复 #

1. 函数目录写入权限限制 #

Azure Functions的context.executionContext.functionDirectory对应函数代码的部署目录，该目录为只读状态，无法写入文件。你的代码中尝试向此目录下的uploads/result.txt写入内容，会直接触发权限错误，导致500状态码。

修复方案：
使用Azure提供的临时可写目录（通过process.env.TEMP获取），并确保目标文件夹存在：

// 替换原文件路径逻辑
const tempDir = process.env.TEMP;
const uploadsDir = `${tempDir}/uploads`;
// 递归创建目录（不存在则自动生成）
await fs.promises.mkdir(uploadsDir, { recursive: true });
const filePath = `${uploadsDir}/result.txt`;

2. Async函数与context.done()混用冲突 #

你的函数声明为async，但在多个分支中调用了context.done()。Azure Functions中，async函数通过返回Promise标识执行完成，手动调用context.done()会打乱执行流程，可能提前终止函数、丢失错误信息。

修复方案：
删除所有context.done()调用，让async函数自然完成。例如GET请求的download分支修改后：

try {
    const tempDir = process.env.TEMP;
    const filePath = `${tempDir}/uploads/result.txt`;
    const fileContent = await readFileAsync(filePath, 'utf8');
    context.res = {
        status: 200,
        body: fileContent,
        headers: {
            'Content-Type': 'text/plain',
            'Content-Disposition': 'attachment; filename=result.txt',
        },
    };
} catch (error) {
    context.log.error('Download error:', error);
    context.res = {
        status: 500,
        body: { error: 'Error downloading file', details: error.message },
    };
}

3. 依赖包未正确部署 #

本地运行正常但部署后报错，常见原因是依赖包（如multer）未被正确上传到Azure。

检查与修复：

• 若使用Zip部署，确保node_modules目录包含在压缩包内；
• 若使用自动部署（如GitHub Actions），在部署脚本中添加npm install --production步骤；
• 通过Kudu控制台（函数App → 高级工具 → Go）进入site/wwwroot目录，检查node_modules下是否存在multer包。

二、调试技巧获取错误详情 #

1. 启用实时日志流 #

在Azure Portal的函数App页面，进入日志流，实时查看请求处理过程中的错误日志，其中会包含具体的错误栈、文件路径错误等关键信息。

2. 添加详细错误日志 #

在所有catch块中添加context.log.error记录完整错误信息，便于排查：

catch (error) {
    context.log.error('Sorting error:', error); // 记录错误到Azure日志
    context.res = {
        status: 500,
        body: { error: 'Internal Server Error', details: error.message, stack: error.stack },
    };
}

3. 使用Kudu控制台验证文件系统 #

通过Kudu控制台进入临时目录（D:\local\Temp），手动创建uploads文件夹并测试写入，确认权限是否正常；同时检查函数目录下的代码是否与本地一致。

三、额外优化建议 #

• 全局变量processingData和sortingRequests是内存态的，函数重启或缩放时会丢失数据，若需持久化，建议使用Azure Storage或数据库；
• 对于文件上传，确保请求的Content-Type为multipart/form-data，且表单字段名与upload.single('inputFile')中的inputFile一致。

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