Чтобы избежать ошибок при добавлении кастомных заголовков в Nginx, можно воспользоваться следующими рекомендациями:

• Использовать директиву moresetheaders. 1 Она позволяет более интуитивно и надёжно управлять HTTP-заголовками, особенно в сложных многоуровневых конфигурациях. 1 Для использования этой директивы нужно установить дополнительный модуль. 1
• Тестировать конфигурацию с помощью команды nginx -t. 2 Если Nginx вернёт ошибки, она часто указывает на номер строки и проблему в файле конфигурации. 2
• Использовать блок map. 2 С его помощью можно сопоставить любое значение с токенами servertokens, а затем использовать это значение в значении сервера директивы addheader. 2
• Проверять наличие директивы underscoresinheaders. 5 Если она отсутствует, заголовки с подчёркиваниями будут фильтруться. 5 Директиву нужно добавить в блок сервера. 5

Перед развертыванием в производство необходимо протестировать конфигурацию и понять последствия сделанных изменений. 2