StyleFrame导出Excel触发AttributeError: 'int'无value属性问题排查

这个异常的核心触发逻辑是StyleFrame对行索引的内部设计要求和当前的操作方式不匹配：

• StyleFrame 导出Excel时，会遍历自身维护的行索引，调用每个索引元素的.value属性获取实际Excel行号——它默认要求索引元素是内置的RowIndex类实例，而非普通Python整数。
• 直接替换底层data_df、用pandas原生concat/reset_index操作的方式，会把原本带RowIndex封装的合法索引直接替换成普通整数，完全丢失.value属性，最终触发属性不存在的报错。
• 调试看到的只读row_indexes属性为整数元组，就是因为硬改data_df后，StyleFrame自动同步了底层的普通整数索引，但没有自动完成RowIndex的封装，和导出逻辑的预期完全错位。

不要直接硬改data_df属性绕过StyleFrame的内部索引校验，可通过以下两种任意一种方式修复：

方案1：用StyleFrame原生API完成拼接（推荐，无内部结构破坏风险） #

全程不触碰底层pandas DataFrame，依靠StyleFrame自带的切片、行追加方法操作，自动维护合法的索引结构，完全匹配当前「保留模板前4行 → 插入AWS成本数据 → 保留模板第5行及以后内容」的业务逻辑：

# 把对齐列后的report_data转成行值列表，适配append_rows的入参要求
aligned_data_rows = report_data.values.tolist()

# 从模板StyleFrame上直接切片拆分需要保留的段落，不碰底层data_df
header_part = org_report[:4]   # 保留模板前4行固定表头
footer_part = org_report[5:]   # 保留模板从第6行开始的固定结构

# 重新拼接完整的StyleFrame实例，内部索引会自动生成为合法的RowIndex类型
org_report = header_part.append_rows(aligned_data_rows).append(footer_part)

执行完上面的拼接逻辑后，直接调用原有导出方法即可，不会触发索引异常。

方案2：手动补全被破坏的索引封装（适合必须保留现有硬拼data_df逻辑的场景） #

如果不想改动现有pandas拼接的代码逻辑，只需要在拼接完成、调用导出方法之前，手动把被替换成普通整数的索引重新封装为StyleFrame要求的类型即可：

from styleframe import RowIndex

# 原有pandas拼接逻辑保留不变
org_report.data_df = concat([
    org_report.data_df.iloc[:4],
    report_data,
    org_report.data_df.iloc[5:]
], axis=0).reset_index(drop=True)

# 手动替换底层索引为合法的RowIndex实例
org_report.data_df.index = [RowIndex(i) for i in range(len(org_report.data_df))]
# 同步更新StyleFrame顶层缓存的row_indexes属性，避免状态不一致
org_report.row_indexes = tuple(RowIndex(i) for i in range(len(org_report.data_df)))

# 后续导出逻辑不变，可正常执行
org_report.to_excel(create_report_name(organisation)).save()

• 不要靠调整pandas层的索引数据类型（比如把索引改成object类型）解决问题，StyleFrame对索引类型的校验是强绑定RowIndex类实例的，普通整数哪怕转成object类型，还是没有.value属性。
• 导出前可以加一行合法性校验，提前定位索引异常：

  # 检查所有行索引是否为带.value属性的合法类型
  for row_idx in org_report.row_indexes:
      assert hasattr(row_idx, "value"), f"非法索引元素：{row_idx}，缺少.value属性"
  

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