Комплексные компоненты, маленький баг [bitrix api]

При работе с комплексными компонентами Bitrix метод CComponentEngine::ParseComponentPath может возвращать false без видимых причин. Потратил немало времени на отладку, пока не нашёл причину.

Причина

Лишний слеш в начале URL-шаблона в массиве $arUrlTemplates.

Неправильно

$arUrlTemplates = array(
    "list" => "/index.php"
);

Правильно

$arUrlTemplates = array(
    "list" => "index.php"
);

Казалось бы, мелочь — один символ. Но именно он заставляет ParseComponentPath вернуть false и всё сломать.

Оставил комментарий в официальной документации, чтобы другие не наступали на те же грабли.