发布Azure Function后调用报InvalidQueryParameterValue 400错误求助

针对你遇到的发布后调用出现400 InvalidQueryParameterValue错误，从以下几个方向排查解决：

1. 检查Function调用URL合法性 #

Azure Function发布后的标准URL格式为：
https://<你的函数应用名称>.azurewebsites.net/api/StoragePostFunction

• 确认调用时未添加多余/无效的查询参数（比如误带了不需要的code参数，你的函数设置为AuthorizationLevel.Anonymous，无需该参数）
• 检查URL是否复制完整，无遗漏或多余字符

2. 验证应用服务环境变量配置 #

本地调试用local.settings.json中的配置，但发布到Azure后，需在Azure Portal -> 你的Function App -> 配置 -> 应用程序设置中手动添加两个变量：

• AzureWebJobsStorage：填入你的Storage账户连接字符串
• ContainerName：填入目标Blob容器名称
  确保两个值和本地配置完全一致，无拼写错误

3. 检查上传文件名的合规性 #

Azure Blob存储对文件名（Blob名称）有严格限制，禁止包含\ / : * ? " < > |等字符，也不能以斜杠结尾。若上传文件名含这类字符，会触发存储服务的400错误：

• 先测试上传简单文件名（如test.txt），验证是否能成功
• 可在代码中对文件名做预处理，替换非法字符：

var safeFileName = Path.GetFileName(file.FileName)
    .Replace("\\", "").Replace("/", "")
    .Replace(":", "").Replace("*", "")
    .Replace("?", "").Replace("\"", "")
    .Replace("<", "").Replace(">", "")
    .Replace("|", "");
var blob = blobClient.GetBlobClient(safeFileName);

4. 确认Postman请求配置正确 #

• 请求方法必须为POST
• 请求体类型选择form-data，键名必须严格为File（和代码中req.Form.Files["File"]对应）
• 不要手动设置错误的请求头（比如误设为application/json，会导致无法解析form-data）

5. 代码优化建议（规避潜在问题） #

你的代码存在冗余初始化，可优化并增加容错处理：

[FunctionName("StoragePostFunction")]
public static async Task<IActionResult> Post(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = null)] HttpRequest req, ILogger log)
{
    string connection = Environment.GetEnvironmentVariable("AzureWebJobsStorage");
    string containerName = Environment.GetEnvironmentVariable("ContainerName");

    // 检查是否上传了文件
    if (!req.Form.Files.Any() || req.Form.Files["File"] == null)
    {
        return new BadRequestObjectResult("未检测到上传文件");
    }

    var file = req.Form.Files["File"];
    var blobClient = new BlobContainerClient(connection, containerName);
    // 确保容器存在，避免因容器未创建导致错误
    await blobClient.CreateIfNotExistsAsync();
    
    // 处理文件名，避免非法字符
    var safeFileName = Path.GetFileName(file.FileName)
        .Replace("\\", "").Replace("/", "")
        .Replace(":", "").Replace("*", "")
        .Replace("?", "").Replace("\"", "")
        .Replace("<", "").Replace(">", "")
        .Replace("|", "");
        
    var blob = blobClient.GetBlobClient(safeFileName);
    await blob.UploadAsync(file.OpenReadStream(), overwrite: true);
    return new OkObjectResult("文件上传成功");
}

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