TYPO3 8.7.10: Неизвестный столбец 'sys_file_reference.uid_local: введите' в 'where clause' в новом расширении со свойством типа файла

Вопрос довольно старый, но у меня все еще была эта проблема в TYPO3 версии 9, и я обнаружил, что она связана с extension-builder, который создает некоторые записи для поля uid_local:type.
Сообщение об ошибке просто блокирует все, потому что поле тип не определен.

На этом снимке экрана вы можете видеть, что поле с таким именем определено в таблице sys_file_reference:

Прокручивая длинный список с полями таблицы вниз, можно обнаружить что-то вроде этого:

Там можно найти определение для config.items, в котором есть типичные определения для некоторых элементов, которые можно выбрать. Даже элемент всего один, структура типична для какой-то формы-элемента для выбора. Я могу представить себе такие элементы формы, как выпадающее меню выбора, переключатели или флажки. Все эти элементы имеют такую ​​структуру кода как определение.

Итак, что я сделал для удаления сообщения об ошибке, так это просто определил «тип» для поля:

$tmp_ttnews_vp_columns['uid_local:type']['config']['type'] = 'select';

С другой стороны, поле обычно не отображается, поскольку таблица sys_file_reference никогда не следует логике extbase и работает иначе. Так что довольно легко и полезно удалить некоторый код в файле
your_extension/Configuration/TCA/Overrides/sys_file_reference.php
В этой таблице есть блок с определениями для новых или измененных полей, и большую часть кода выше или ниже этого списка можно удалить.

Он находится над определениями столбцов и может быть удален:

И такой блок, как этот ниже, также можно удалить с желаемым кодом:

Документацию о поле type можно найти здесь, в главе внизу также объясняется комбинированная нотация, но не с uid_local, а с file: file:type.

Есть много ситуаций и подробностей, почему это не сработало, вот известные случаи, я могу расширить список на основе комментариев позже:

• Отображение по умолчанию, созданное расширением-построителем, выглядит примерно так:

config.tx_extbase {
persistence {
 classes {

   WDB\TtnewsVp\Domain\Model\FileReference {
     mapping {
       tableName = sys_file_reference
       recordType = Tx_TtnewsVp_FileReference
     }
   }

 }
}
}

здесь строка recordType = Tx_TtnewsVp_FileReference вызывает беспокойство и вызывает сообщение об ошибке, как описано в вопросе.
Этот тип TypoScript обычно находится в файле ext_typoscript_setup.typoscript в корне папки расширения, поэтому он всегда загружается, даже если статический шаблон не входит.

• Аннотации в классах могут быть неправильными, включая простые ошибки, такие как опечатки. Аннотации и подсказки типов должны быть правильными (возможно, отсутствующий вариант лучше, чем неправильный, но я никогда не пробовал использовать отсутствующие аннотации или подсказки типа).