Диагностическая карта ошибки 500 при добавлении SharePoint-приложения: определяем формат пакета и поколение модели, разделяем публичную карточку, Apps site, разрешения и установку на сайт.
Определите поколение и формат пакета
Зафиксируйте расширение и модель: современное решение SharePoint Framework обычно распространяется как .sppkg через Apps site, тогда как классический SharePoint Add-in использовал .app. Microsoft сообщает, что модель SharePoint Add-in для SharePoint Online полностью снята с эксплуатации 2 апреля 2026 года. Это не доказывает причину каждого HTTP 500, но меняет первую диагностическую развилку. Не пытайтесь загружать старый пакет в новый путь без проверки документации продукта.
Разделите четыре поверхности процесса
Проверьте отдельно: открывается ли публичная карточка приложения; куда ведёт кнопка Add до ответа 500; появляется ли решение на Apps site; доступно ли оно на тестовом SharePoint-сайте. Сохраните HTTP-статус, конечный домен и correlation ID, если он показан, но удалите tenant ID и параметры авторизации. Один ответ 500 на переходе не подтверждает, что пакет повреждён: запрос мог не дойти до каталога организации.
Проверьте Apps site по текущей модели
Официальная инструкция для SharePoint in Microsoft 365 предлагает администраторам добавлять решения из SharePoint Store на Apps site либо загружать собственные .sppkg, после чего они становятся доступны владельцам сайтов. На тестовом тенанте или разрешённом тестовом сайте проверьте наличие приложения и права администратора. Не включайте Add to all sites: широкое развёртывание не является диагностикой и увеличивает последствия ошибки.
Проведите один обратимый тест пути
Выберите безопасное тестовое решение того же формата, которое уже разрешено организацией, и пройдите тот же путь только до Apps site. Затем сравните конечные URL и этап, где расходятся результаты. Не меняйте листинг, манифест, разрешения и адрес перенаправления одновременно. Если собственная карточка падает до входа в тенант, сохраните HAR без cookies и токенов; если после входа — добавьте обезличенный correlation ID и время в UTC.
Соберите доказательства без рискованного развёртывания
Для Microsoft или владельца магазина подготовьте модель пакета, расширение, версию SPFx или Add-in, UTC-время, цепочку переходов по доменам, HTTP-статус, correlation ID и результат контрольного приложения. Отдельно укажите, относится ли решение к снятой модели Add-in. Остановитесь до удаления Apps site, повторной регистрации приложения или массового включения. Формулируйте проблему как сбой конкретной границы, пока логи не подтвердят более узкую причину.
Материал подготовлен самостоятельно с автоматизацией и редакционно проверен 30 июля 2026 года по обезличенному сигналу Microsoft Q&A и официальной документации Microsoft; названия компаний, приложений и тенантов не использовались.
Источники и проверка
- Microsoft Learn — управление приложениями через Apps site проверено 2026-07-30
- Microsoft Learn — варианты публикации SharePoint Add-ins проверено 2026-07-30
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.