Shopware 6.4.14.0自定义字段排序异常：字段集正常产品实体乱序

问题详情 #

• 在Shopware 6.4.14.0后台创建自定义字段，配置中指定customFieldPosition为3（字段JSON配置如下）
• 自定义字段集（Custom Field Sets）内的字段排序显示正常
• 但在产品实体（Product Entities）编辑页面，自定义字段的排列顺序错乱

字段配置示例 #

{"customFieldPosition":3,"label":{"de-DE":"Anzahl der Mahlzeiten 1","en-GB":"Number of meals 1","pl-PL":"Ilość posiłków 1"},"placeholder":{"de-DE":"Geben Sie die Anzahl der Mahlzeiten ein","en-GB":"Enter the number of meals","pl-PL":"Wprowadź ilość posiłków"}}

页面表现 #

• 自定义字段集定义页面：字段排序符合设置的位置顺序，显示正常
• 产品实体页面：字段排列顺序混乱，未遵循customFieldPosition的设置

解决方案 #

1. 清理系统缓存 #

Shopware后台UI可能缓存了旧的排序配置，执行以下命令清除缓存：

bin/console cache:clear
bin/console cache:warmup

同时进入后台「设置 -> 系统 -> 缓存管理」，点击「清除缓存」按钮清理前端缓存。

2. 检查字段集实体关联设置 #

确认自定义字段集与产品实体的关联是否存在排序覆盖：

• 打开自定义字段集编辑页面，切换到「实体分配」标签
• 查看产品实体的关联配置，若开启了「自定义排序」，需手动调整排序或关闭该选项，让字段使用自身的customFieldPosition值排序

3. 修复数据库字段位置值 #

数据库中custom_field表的position字段可能存在重复或异常值，导致排序逻辑失效：

• 执行SQL查询检查目标字段集下的字段位置：

SELECT name, position FROM custom_field WHERE set_id = '你的字段集ID';

• 确保每个字段的position值唯一且连续，若有异常，手动更新为正确顺序

4. 升级Shopware版本 #

Shopware 6.4.14.0存在自定义字段排序的已知bug，官方在后续6.4.x稳定版本中修复了该类问题，建议升级到6.4.20.0及以上版本。

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