Composer: "./composer.json" does not contain valid JSON — ошибка в composer.json
Composer не смог прочитать composer.json: в файле ошибка записи — лишняя запятая, не та или незакрытая кавычка, комментарий. Ниже Composer пишет номер строки и что ожидал на этом месте. Откройте файл, исправьте строку и проверьте его командой composer validate.
Содержание 17
- Что сделать прямо сейчас
- Как выглядит ошибка
- Как найти строку с ошибкой
- Что значат подсказки
- Что значит Expected
- Если пишет про обратную черту
- Если пишет Comments are not allowed
- Если пишет BOM detected
- Если пишет is not UTF-8
- Если ключ повторяется
- Как проверить файл
- Если пишет does not match the expected JSON schema
- Если Composer не находит composer.json
- Как не ошибиться в composer.json
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Посмотрите номер в строке
Parse error on line …— это строка composer.json, на которой Composer споткнулся. - Откройте файл и исправьте эту строку или строку над ней — что значат подсказки.
- Проверьте файл командой
composer validateи запустите команду Composer снова.
Как выглядит ошибка
"./composer.json" does not contain valid JSON
Parse error on line 4:
…
Expected: 'STRING' - It appears you have an extra trailing commaПервая строка — «файл ./composer.json — не правильный JSON». ./composer.json — composer.json в текущей папке. Вторая — «ошибка разбора в строке 4». Ниже, на месте многоточия, — кусок файла около ошибки, склеенный в одну строку, а под ним черта из минусов со стрелкой ^: стрелка показывает, где Composer споткнулся. Последняя строка — что он ожидал на этом месте и подсказка. Здесь — «ожидалась строка в кавычках; похоже, лишняя запятая».
Над сообщением бывает строка In JsonFile.php line …: — это место в коде самого Composer, а не в вашем файле.
Ошибка появляется при любой команде — composer install, composer update, composer require: каждая сначала читает composer.json. Пока файл не исправлен, Composer ничего не ставит и не меняет.
Как найти строку с ошибкой
Перейдите в папку проекта и покажите файл с номерами строк:
cd /var/www/example.com
cat -n composer.jsonЧисло слева — номер строки. Composer называет строку, на которой споткнулся, а сама ошибка бывает и строкой выше. Пример — лишняя запятая:
{
"require": {
"example/library": "^2.0",
}
}Запятая стоит в конце строки 3, а Composer пишет Parse error on line 4 — на строке 4 скобка }, перед которой запятой быть не должно. Исправленный файл:
{
"require": {
"example/library": "^2.0"
}
}Перед правкой сделайте копию файла, затем откройте его в редакторе nano:
cp composer.json composer.json.bak
nano composer.jsonСохранить — Ctrl+O и Enter, выйти — Ctrl+X.
Что значат подсказки
Подсказка стоит в последней строке сообщения:
| Подсказка | Что не так | Как исправить |
|---|---|---|
It appears you have an extra trailing comma | запятая после последнего элемента, перед } или ] | уберите эту запятую |
it appears you used single quotes instead of double quotes | строка в одинарных кавычках: '^2.0' | замените на двойные: "^2.0" |
it appears you have an unescaped backslash at: … | одна обратная черта \ внутри строки | пишите две: \\ — пример |
it appears you forgot to terminate a string, or attempted to write a multiline string which is invalid | строку не закрыли кавычкой или перенесли на новую строку | закройте кавычку, строку пишите в одну строку |
Expected one of: … или Expected: … | на этом месте должен быть другой знак | что Composer ожидал |
Первые три подсказки начинаются словами Invalid string — «неправильная строка».
Что значит Expected
После Expected one of: или Expected: Composer перечисляет, что могло стоять на месте стрелки:
| В списке | Что это |
|---|---|
'STRING' | строка в двойных кавычках |
'NUMBER' | число |
'TRUE', 'FALSE', 'NULL' | слова true, false, null |
'{', '}', '[', ']' | скобки |
',' | запятая |
':' | двоеточие |
'EOF' | конец файла |
Если в списке ',' и '}', между двумя строками не хватает запятой:
"example/library": "^2.0"
"example/other": "^1.0"Поставьте запятую в конце первой строки. Если в списке 'EOF', после последней скобки } в файле лишний текст — удалите его.
Если в файле есть строки <<<<<<<, ======= и >>>>>>>, это следы объединения веток в git: выберите нужный вариант и удалите эти строки — composer.lock после слияния.
Если пишет про обратную черту
В JSON обратная черта пишется двумя знаками: \\. Ошибка бывает в разделе autoload, где записаны пространства имён PHP:
"autoload": {
"psr-4": {
"Example\Library\": "src/"
}
}Здесь Example\Library — пример. Правильно:
"autoload": {
"psr-4": {
"Example\\Library\\": "src/"
}
}Так же пишутся классы в разделе scripts — например, Composer\\Config::disableProcessTimeout: пример.
Если пишет Comments are not allowed
Lexical error on line 3. Comments are not allowed.«Ошибка в строке 3: комментарии не разрешены». В JSON нет комментариев — ни // …, ни /* … */. Удалите их из composer.json.
Если пишет BOM detected
BOM detected, make sure your input does not include a Unicode Byte-Order-Mark«В начале файла метка BOM — уберите её». BOM — три невидимых байта в начале файла; их добавляют некоторые редакторы, когда сохраняют файл в UTF-8. Проверьте:
head -c 3 composer.json | od -An -tx1Если в ответе ef bb bf, метка есть. Уберите её:
sed -i '1s/^\xEF\xBB\xBF//' composer.jsonЕсли правите файл на своём компьютере, сохраняйте его в кодировке UTF-8 без BOM.
Если пишет is not UTF-8
"./composer.json" is not UTF-8, could not parse as JSON«Файл не в кодировке UTF-8, прочитать его нельзя». Так бывает, если в файле есть русские буквы — например, в поле description, — а файл сохранили в кодировке Windows-1251. Перекодируйте его:
iconv -f WINDOWS-1251 -t UTF-8 composer.json > composer.json.new
mv composer.json.new composer.jsonПроверьте файл командой composer validate.
Если ключ повторяется
Если в файле два раздела с одним именем — например, два require, — Composer ошибку не пишет: он берёт последний раздел, а первый пропускает. Библиотеки из первого раздела не поставятся.
Повтор покажет composer validate:
./composer.json is valid, but with a few warnings
See https://getcomposer.org/doc/04-schema.md for details on the schema
# General warnings
- Key require is a duplicate in ./composer.json at line …«Ключ require повторяется в ./composer.json, в строке …». Перенесите библиотеки из обоих разделов в один, второй удалите.
Как проверить файл
В папке проекта выполните:
composer validateЧто значит ответ:
| Ответ | Что значит |
|---|---|
./composer.json is valid | файл в порядке |
is valid, but with a few warnings | файл читается, замечания — ниже, под строкой # General warnings |
is valid for simple usage with Composer but has | файл в порядке для сайта; замечания касаются публикации библиотеки на Packagist |
is valid but your composer.lock has some errors | composer.json в порядке, а composer.lock устарел — разбор |
is invalid, the following errors/warnings were found: | ошибки — ниже, под строкой # General errors |
./composer.json not found. | в этой папке нет composer.json — что делать |
Замечание, которое бывает у сайтов:
- No license specified, it is recommended to do so. For closed-source software you may use "proprietary" as license.«Лицензия не указана; для закрытого кода можно указать "proprietary"». Сайту это не мешает. Чтобы замечание пропало, добавьте в composer.json строку "license": "proprietary",.
Код выхода composer validate: 2 — есть ошибки, 3 — файла нет или его нельзя прочитать. С ключом --strict код 1 — есть только замечания.
Если пишет does not match the expected JSON schema
"./composer.json" does not match the expected JSON schema:
- …«Файл не подходит под схему composer.json». Запись правильная, но раздел записан не в том виде: ниже, после - , — имя раздела и что с ним не так. Например, require — это список в фигурных скобках {"имя/пакета": "версия"}, а не одна строка. Сверьте раздел с описанием composer.json.
Если Composer не находит composer.json
Composer could not find a composer.json file in /home/user
To initialize a project, please create a composer.json file. See https://getcomposer.org/basic-usage«Composer не нашёл composer.json в папке /home/user. Чтобы начать проект, создайте composer.json». Composer ищет файл в текущей папке — значит, вы не в папке проекта. Перейдите в неё и проверьте, что файл там:
cd /var/www/example.com
ls composer.jsonЕсли не знаете, где проект, найдите composer.json в папке сайтов:
find /var/www -maxdepth 3 -name composer.json -not -path '*/vendor/*'Как не ошибиться в composer.json
- Добавляйте библиотеки командой
composer require example/library: Composer сам впишет строку в composer.json без ошибок в записи. - Убирайте командой
composer remove example/library. - Если правите файл вручную, после правки запустите
composer validate.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
"./composer.json" does not contain valid JSON | ошибка записи в composer.json | найдите строку |
It appears you have an extra trailing comma | лишняя запятая перед } или ] | уберите запятую |
it appears you used single quotes instead of double quotes | одинарные кавычки | замените на двойные |
it appears you have an unescaped backslash at: | одна обратная черта | пишите две |
Expected one of: и в списке ',' | не хватает запятой или другого знака | что Composer ожидал |
Comments are not allowed. | комментарий в файле | удалите комментарий |
BOM detected | метка BOM в начале файла | уберите метку |
is not UTF-8, could not parse as JSON | файл не в UTF-8 | перекодируйте |
does not match the expected JSON schema | раздел записан не в том виде | сверьте раздел |
Composer could not find a composer.json file in | вы не в папке проекта | перейдите в папку проекта |
Key … is a duplicate in | два раздела с одним именем | объедините разделы |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: проверка файла в Json/JsonFile.php, поиск composer.json в Factory.php, ответы composer validate в Command/ValidateCommand.php и Util/ConfigValidator.php.
- Исходный код jsonlint 1.10.2 — на английском: подсказки Parse error, Comments are not allowed и BOM detected в JsonParser.php и Lexer.php.
- Описание composer.json — на английском: разделы файла.
- Команды Composer — на английском: validate, require и remove.
Сверено 13 ноября 2026 года.
Что почитать дальше
- The lock file is not up to dateесли composer.json поправили, а composer.lock нет.
- Could not find packageесли Composer не находит библиотеку.
- Ошибки Composerвсе ошибки Composer на одной странице.