切换Google Search Console项目后Pandas报NoneType无head属性错误

你遇到的报错本质是df变量被赋值为None，才会不存在head方法。结合代码逻辑，可能的原因分为3类，按排查优先级排序：

1. 站点域名配置不匹配，导致webproperty为空 #

• Google Search Console的站点录入格式分为前缀型和域名型，你当前填的https://www.fabbriboutiques.com/it/是子路径前缀，先确认GSC后台你的站点是不是确实按这个完整路径录入的：
  • 如果是域名型站点，格式应该是sc-domain:fabbriboutiques.com，直接填域名前缀会读取不到资源
  • 如果是前缀型，确认有没有漏写/多写尾斜杠、http和https有没有写错、www有没有加，必须和GSC后台显示的完全一致才能匹配到资源
• 可以先在webproperty = account[domain_name]后面加一行print(webproperty)，运行后看输出是不是None，如果是，就是这个原因。

2. 账号权限不足 #

你当前用的认证凭据对应的Google账号，有没有给新切换的这个GSC站点开通至少只读权限？如果凭据账号没有站点访问权限，account对象也会读取不到对应webproperty，返回空值。

3. 站点无有效返回数据，导致DataFrame构建失败 #

就算webproperty匹配成功，如果站点近365天完全没有搜索曝光数据，r.rows会是空列表，你可以在函数里加打印调试，确认拉取逻辑是否正常：

def get_search_console_data(webproperty, days=-365): 
  if webproperty is not None:
    print("webproperty匹配成功，正在拉取数据")
    query = webproperty.query.range(start='today', days=days).dimension('date', 'query')
    r = query.get()
    print(f"拉取到的行数：{len(r.rows)}")
    df = pd.DataFrame(r.rows)
    print(f"构建的df是否为空：{df.empty}")
    return df

  print("Web property不存在，请从下列列表中选择有效项")
  print(account.webproperties)
  return None

临时兼容方案 #

调用df方法前先加非空判断，避免直接报错：

df = get_search_console_data(webproperty) 
if df is not None and not df.empty:
    df.head()
    df.info()
    df.to_csv("canadahelps.csv")
else:
    print("未获取到有效数据")

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