Поиск
Ошибки

Composer: "./composer.json" does not contain valid JSON — ошибка в composer.json

Composer не смог прочитать composer.json: в файле ошибка записи — лишняя запятая, не та или незакрытая кавычка, комментарий. Ниже Composer пишет номер строки и что ожидал на этом месте. Откройте файл, исправьте строку и проверьте его командой composer validate.

≈ 9 мин чтения
Содержание 17

Что сделать прямо сейчас

  1. Посмотрите номер в строке Parse error on line … — это строка composer.json, на которой Composer споткнулся.
  2. Откройте файл и исправьте эту строку или строку над ней — что значат подсказки.
  3. Проверьте файл командой 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 errorscomposer.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.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше