Shopware 6后台CSV导出接口认证与文件获取实现问题

一、修正控制器的响应输出 #

你的控制器代码存在初始化缺失和响应头配置问题，需要调整为以下形式，确保浏览器识别为CSV文件并触发下载：

/**
 * @Route(
 *     "/api/winkelwagen/export/csv/{id}",
 *     methods={"GET"},
 *     defaults={"auth_required"=true, "_routeScope"={"api"}}
 * )
 */
public function export(string $id, Context $context, Request $request): Response
{
    // 替换为实际的CSV生成逻辑，比如根据$id获取数据并拼接CSV内容
    $csvContent = "列1,列2\n数据1,数据2\n数据3,数据4";
    
    $response = new Response($csvContent);
    // 设置CSV的MIME类型
    $response->headers->set('Content-Type', 'text/csv');
    // 强制浏览器以附件形式下载，指定文件名
    $response->headers->set('Content-Disposition', 'attachment; filename="winkelwagen-export.csv"');
    
    return $response;
}

二、前端处理认证与跳转 #

Shopware后台登录后，用户的认证信息会存储在Cookie中，新窗口打开API地址时会自动携带这些Cookie，只要满足两个前提：

• API路由已设置_routeScope={"api"}（你的代码已配置）
• 当前后台用户拥有该API路由的访问权限（需在插件的src/Resources/config/privileges.xml中配置对应权限）

因此前端可以直接修改为打开API地址：

// 替换yourId为实际的ID值
window.open('/api/winkelwagen/export/csv/' + yourId, '_blank');

若遇到Cookie无法携带的特殊情况（如SameSite配置限制），可改用Shopware Admin SDK发起请求，通过Blob生成下载链接：

Shopware.Service('httpClient').get('/api/winkelwagen/export/csv/' + yourId, {
    responseType: 'blob'
}).then(response => {
    const url = window.URL.createObjectURL(new Blob([response.data]));
    const downloadLink = document.createElement('a');
    downloadLink.href = url;
    downloadLink.setAttribute('download', 'winkelwagen-export.csv');
    document.body.appendChild(downloadLink);
    downloadLink.click();
    window.URL.revokeObjectURL(url);
    document.body.removeChild(downloadLink);
});

三、更优方案：复用Shopware后台原生导出机制 #

Shopware后台自带成熟的导出体系，推荐集成该机制，无需自行编写API控制器，更符合后台统一规范：

1. 在后台组件中通过事件触发导出：

this.$root.$emit('download-export', {
    entity: 'promotion', // 替换为你的目标实体
    fileName: 'winkelwagen-export.csv',
    columns: [
        { property: 'name', label: this.$tc('sw-promotion.list.columnName') },
        { property: 'active', label: this.$tc('sw-promotion.list.columnActive') }
        // 根据需求定义导出列
    ],
    // 添加过滤条件，仅导出指定ID的数据
    filter: { id: yourId }
});

这种方式会自动处理认证、数据查询、CSV生成和下载流程，与后台原生导出体验完全一致。

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