Azure Function中JSON转XLSX报错：ValueError索引问题求助

在Azure Function中尝试解析URL查询参数中的JSON数据，转换为XLSX文件并存储至Blob存储容器时出现报错，报错信息如下：

File "/home/site/wwwroot/.python_packages/lib/site-packages/pandas/core/internals/construction.py", line 114, in arrays_to_mgr index = _extract_index(arrays) ^^^^^^^^^^^^^^^^^^^^^^ File "/home/site/wwwroot/.python_packages/lib/site-packages/pandas/core/internals/construction.py", line 667, in _extract_index raise ValueError("If using all scalar values, you must pass an index")

当前使用的代码：

import logging
import os
import json
import pandas as pd
import azure.functions as func
from azure.storage.blob import BlobServiceClient

def main(req: func.HttpRequest) -> func.HttpResponse:
logging.info('Python HTTP trigger function processed a request.')

# Retrieve JSON data from query parameters
json_data = req.params.get("json_data")

if not json_data:
    return func.HttpResponse("Error: 'json_data' parameter is missing.", status_code=400)

# Parse the JSON data
try:
    json_data = json.loads(json_data)
except json.JSONDecodeError:
    return func.HttpResponse("Error: Invalid JSON data.", status_code=400)

# Create a DataFrame from the JSON data
df = pd.DataFrame(json_data)

# Specify the output XLSX file path
xlsx_file_path = '/tmp/output.xlsx'

# Convert the DataFrame to an XLSX file
df.to_excel(xlsx_file_path, index=False)

# Azure Blob Storage settings
STORAGEACCOUNTURL = MY_URL
STORAGEACCOUNTKEY = MY_KEY
CONTAINERNAME = 'demo'
BLOBNAME = 'output.xlsx'

# Create a BlobServiceClient to work with Blob Storage
blob_service_client_instance = BlobServiceClient(account_url=STORAGEACCOUNTURL, credential=STORAGEACCOUNTKEY)

# Get a container client
container_client = blob_service_client_instance.get_container_client(CONTAINERNAME)

# Upload the XLSX file to the container
with open(xlsx_file_path, mode="rb") as data:
    blob_client = container_client.upload_blob(name=BLOBNAME, data=data, overwrite=True)

return func.HttpResponse(f'Success: Converted and uploaded {BLOBNAME}')

核心问题 #

报错的本质是传入pd.DataFrame()的JSON格式不符合pandas的要求：

• 当JSON是**单层键值对结构（例如{"name": "Alice", "age": 30}）**时，pandas会将每个值识别为标量，无法自动生成DataFrame的索引，因此抛出该错误。
• pandas创建DataFrame需要的是列表型数据（例如[{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]），或者需要显式指定索引。

修复方案 #

根据不同的JSON输入场景，有两种处理方式：

1. 将单层JSON转为列表格式 #

如果输入的JSON是单层键值对，在创建DataFrame前将其包装为列表：

# Create a DataFrame from the JSON data
# 检查是否为字典类型（单层键值对），转为列表
if isinstance(json_data, dict):
    json_data = [json_data]
df = pd.DataFrame(json_data)

2. 显式指定索引 #

如果需要保留原键值对结构并转为单行DataFrame，可以直接指定索引：

df = pd.DataFrame(json_data, index=[0])

额外优化建议 #

• Azure Function的/tmp目录是临时存储，多请求并发时可能出现文件覆盖问题，建议给生成的XLSX文件添加唯一标识（比如UUID）：

  import uuid
  BLOBNAME = f'output_{uuid.uuid4().hex}.xlsx'
  xlsx_file_path = f'/tmp/{BLOBNAME}'
  

• 代码中STORAGEACCOUNTURL和STORAGEACCOUNTKEY是硬编码占位符，建议改为从Azure Function应用设置中读取，避免密钥泄露：

  STORAGEACCOUNTURL = os.environ.get("STORAGEACCOUNTURL")
  STORAGEACCOUNTKEY = os.environ.get("STORAGEACCOUNTKEY")
  

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