Piwik/Matomo 5.1.0版本中创建漏斗功能报错问题解析

在Piwik/Matomo 5.1.0版本中，部分用户在创建漏斗时遇到了一个数据库错误。当用户尝试在"漏斗"功能中添加新漏斗并填写完所有必填字段后，系统会抛出"Mysqli prepare error: Unknown column 'name' in 'field list'"的错误提示。

问题本质分析

这个错误表明系统在尝试向数据库表中插入数据时，发现了一个不存在的列名'name'。具体来说，当用户提交漏斗创建请求时，应用程序试图向matomo_funnel表中写入数据，但该表缺少了预期的'name'字段。

根本原因

经过技术分析，这个问题源于数据库表结构未正确更新。在Matomo 5.1.0版本中，漏斗功能需要matomo_funnel表包含一个名为'name'的VARCHAR(50)类型字段，该字段应该位于'revision'字段之后。如果用户从早期版本升级到5.1.0但未完整执行数据库迁移脚本，就会出现这种表结构不匹配的情况。

解决方案

对于遇到此问题的用户，有以下两种解决方法：

1. 完整执行系统更新命令： 在Matomo安装目录下运行以下命令：

   ./console core:update
   

   这个命令会自动执行所有必要的数据库迁移脚本，包括添加缺失的字段。

2. 手动修改数据库表结构： 如果由于某些原因无法执行自动更新，可以手动执行SQL语句来添加缺失的字段：

   ALTER TABLE matomo_funnel ADD name VARCHAR(50) NOT NULL AFTER revision;
   

   注意：实际表名可能因安装配置而异，需根据具体情况调整。

注意事项

需要特别说明的是，漏斗功能属于Matomo的Premium(付费)功能。如果用户在解决此问题后仍然遇到其他相关问题，建议直接联系Matomo官方支持团队获取进一步帮助，因为核心开源项目的问题跟踪系统通常不处理Premium功能的支持请求。

预防措施

为避免此类问题，建议用户在升级Matomo时：

1. 仔细阅读版本升级说明
2. 确保完整执行所有升级步骤
3. 在升级前后备份数据库
4. 在测试环境中先验证升级过程

通过以上措施，可以最大限度地减少升级过程中可能出现的表结构不匹配问题。