Silverstripe Gridfield导出CSV首列无数据问题排查与解决

在SilverStripe的ModelAdmin中自定义CSV导出列时，生成的CSV文件首列始终只有列名，无对应数据，无论设置哪一列作为首列都会出现这个问题。

ModelAdmin中的代码： #

public function getExportFields()
{
    $model = singleton($this->modelClass);
    if ($model->hasMethod('getExportFields')) {
        return $model->getExportFields();
    }
    return singleton($this->modelClass)->summaryFields();
}

Model中的代码： #

public function getExportFields() {
    return [           
        'OutageDate', 
        'Reference',
        'Notice',
        'Active'
    ];
}

临时 workaround： #

添加空列作为首列后，后续列能正常导出数据：

public function getExportFields() {
    return [ 
        '',          
        'OutageDate', 
        'Reference', 
        'Notice',
        'Active'
    ];
}

问题原因： #

SilverStripe的CSV导出逻辑对纯索引数组（仅值的数组）的处理存在索引偏移问题。当getExportFields返回纯字段名数组时，底层代码在映射列名和数据时，首列的字段名无法正确关联到对应的数据字段，导致数据无法填充。

修复方案： #

将getExportFields返回的数组改为键值对形式，键为CSV列的显示名称，值为模型的字段名（或数据访问器方法名）。这样导出逻辑能准确关联列名与对应数据，避免索引偏移。

示例修复代码（保持列名与字段名一致）：

public function getExportFields() {
    return [           
        'OutageDate' => 'OutageDate', 
        'Reference' => 'Reference',
        'Notice' => 'Notice',
        'Active' => 'Active'
    ];
}

如果需要自定义友好的列显示名称：

public function getExportFields() {
    return [           
        '中断日期' => 'OutageDate', 
        '参考编号' => 'Reference',
        '通知内容' => 'Notice',
        '是否激活' => 'Active'
    ];
}

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