TYPO3 12.4+Solr 12.0.5：商品编号无法加入索引的问题排查

环境信息 #

• TYPO3版本：12.4
• EXT:solr版本：12.0.5

问题原因分析 #

你的配置中product_article_number字段的语法存在冗余，且未指定Solr识别的字段类型后缀，导致该字段无法被正确索引。

修正后的配置 #

将原字段配置替换为以下代码，核心调整字段定义方式并添加类型后缀：

plugin.tx_solr {
    // 其他原有配置保持不变
    index {
        queue {
            tx_my_project_domain_model_product = 1
            tx_my_project_domain_model_product.table = tx_my_project_domain_model_product
            tx_my_project_domain_model_product.fields {
                // 修正后的商品编号字段配置
                product_article_number_textS = TEXT
                product_article_number_textS {
                    field = article_number
                }
                // 其他字段配置保持不变
            }
        }
    }
}

关键修正点 #

1. 添加字段类型后缀：_textS是EXT:solr默认支持的动态字段类型，对应Solr中的字符串文本字段，确保字段能被Solr正确识别并存储。
2. 简化配置语法：移除多余的product_article_number = SOLR_CONTENT，直接通过TEXT cObject映射数据库字段article_number，符合EXT:solr的索引配置规范。

后续验证步骤 #

1. 清理TYPO3所有缓存（包括配置缓存、页面缓存）
2. 在Solr管理后台重载当前核心的配置
3. 执行全量重新索引操作（可通过TYPO3后台Solr模块的「重新索引全部」或命令行vendor/bin/typo3 solr:index:queue --all）
4. 检查Solr索引，确认product_article_number_textS字段已存在

额外排查项 #

• 确认商品表tx_my_project_domain_model_product的article_number字段存在有效数据
• 检查Solr核心的schema配置，确保*_textS动态字段已定义（EXT:solr默认模板已包含该配置）

内容的提问来源于stack exchange，提问作者Jeroen van Veghel