使用Azure Functions-App下载Blob文件时遇资源名称无效字符错误

针对你遇到的本地运行正常、云端部署后执行Blob下载/上传时触发HttpResponseError: The specified resource name contains invalid characters错误，可从以下几个方向排查解决：

1. 检查云端连接字符串配置 #

• 登录Azure Portal，进入你的Function App，在配置 > 应用程序设置中找到CONNECTION_STRING，确认值没有多余的空格、换行或引号。复制粘贴时容易引入这类隐形字符，本地.env文件可能自动忽略，但云端SDK会严格解析。
• 验证连接字符串格式：确保是标准格式 DefaultEndpointsProtocol=https;AccountName=你的存储账户名;AccountKey=你的密钥;EndpointSuffix=core.windows.net，无拼写错误（比如AccountName误写为Accountname）。

2. 临时路径兼容性测试 #

Azure Functions Linux环境的临时目录默认是/tmp，可尝试硬编码路径替代tempfile.gettempdir()，排除路径拼接可能带来的隐性问题：

# 替换原路径代码
filepath = "/tmp/data.csv"

3. 对齐本地与云端的SDK版本 #

检查本地开发环境和云端部署的azure-storage-blob SDK版本是否一致：

• 本地执行pip show azure-storage-blob查看版本，然后在requirements.txt中明确指定该版本（比如azure-storage-blob==12.19.1），避免云端自动安装不同版本导致的解析逻辑差异。

4. 再次验证容器与Blob名称的合法性 #

即使你已排查过，仍需确认：

• 容器名称必须为小写，仅包含字母、数字和短横线，且短横线不能作为首尾字符；
• Blob名称不能包含\ / : * ? " < > |字符，也不能以/开头；
• 检查是否存在不可见字符（如全角空格），可直接从Azure Portal复制容器和Blob名称到代码中替换原有值测试。

修正后的示例代码：

import os
from azure.storage.blob import BlobClient

def main():
    conn_str = os.getenv('CONNECTION_STRING')
    if not conn_str:
        raise ValueError("未配置CONNECTION_STRING环境变量")

    blob_client = BlobClient.from_connection_string(
        conn_str=conn_str,
        container_name="data",
        blob_name="data.csv"
    )

    # 使用硬编码临时路径
    filepath = "/tmp/data.csv"
    with open(filepath, mode="wb") as file:
        download_stream = blob_client.download_blob()
        file.write(download_stream.readall())

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