如何解决Firestore返回文档字段顺序不一致转Pandas DataFrame问题

Firestore 的 doc.to_dict() 方法返回的字典键顺序不固定，你当前的实现是拆分每个文档的键、值单独存储，每次循环取的键顺序可能发生变化，最终赋值列名时就会出现值和列不匹配的错位问题。

不需要提前获知字段名，直接将每个文档转换后的完整字典存入列表，Pandas 会自动根据字典的键对齐所有行的列，从根源上避免顺序错位问题。

修正后代码 #

import pandas as pd
import firebase_admin
from firebase_admin import credentials, firestore

cred = credentials.Certificate(serviceAccountKeyJson)
firebase_admin.initialize_app(cred, databaseURL)
db = firestore.client()

col_ref = db.collection(collection_name)
docs = col_ref.stream()

rows_list = []
for doc in docs:
    # 直接存入完整字典，保留键和值的对应关系
    rows_list.append(doc.to_dict())

# Pandas 自动提取所有字典的键作为统一列名，自动对齐值
col_data_df = pd.DataFrame(rows_list)

# 可选：如果需要固定列的顺序，比如按字母序排列，可加下面一行
# col_data_df = col_data_df.reindex(sorted(col_data_df.columns), axis=1)

• 无需提前知道任何字段名，所有列名自动从文档数据中提取
• 完全规避字段顺序不一致导致的错位问题，每个值都会匹配到对应的字段
• 兼容存在字段缺失的文档场景，缺失字段会自动填充 NaN 值

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