{"id":81674,"date":"2026-07-27T08:58:10","date_gmt":"2026-07-27T12:58:10","guid":{"rendered":"https:\/\/memberpress.com\/docs\/fix-trait-not-found-error-after-updating-memberpress\/"},"modified":"2026-07-27T08:58:10","modified_gmt":"2026-07-27T12:58:10","slug":"fix-trait-not-found-error-after-updating-memberpress","status":"publish","type":"ht_kb","link":"https:\/\/memberpress.com\/pt\/docs\/fix-trait-not-found-error-after-updating-memberpress\/","title":{"rendered":"Como corrigir o erro \u201cTrait Not Found\u201d ap\u00f3s a atualiza\u00e7\u00e3o do MemberPress"},"content":{"rendered":"

Ap\u00f3s uma atualiza\u00e7\u00e3o do MemberPress, um site pode travar e exibir um erro fatal de PHP. O erro indica que uma trait ou classe dentro do MemberPress\\N\u00edvel do solo<\/code><\/strong> O namespace n\u00e3o foi encontrado.<\/p>\n\n\n\n

O erro se origina do cache do servidor, e n\u00e3o do pr\u00f3prio MemberPress. Isso n\u00e3o significa que haja perda ou danos aos dados. Todas as assinaturas, membros e configura\u00e7\u00f5es permanecem seguras no banco de dados.<\/p>\n\n\n\n

Este documento explica o que causa o erro e como corrigi-lo. As solu\u00e7\u00f5es v\u00e3o desde recarregar a p\u00e1gina at\u00e9 enviar uma breve solicita\u00e7\u00e3o ao provedor de hospedagem.<\/p>\n\n\n\n

Entendendo o erro<\/a><\/h2>\n\n\n\n

Ap\u00f3s uma atualiza\u00e7\u00e3o MemberPress, o site pode exibir o \u201cOcorreu um erro grave neste site.\u201d<\/strong> mensagem. O erro fatal relacionado aparece no Registro de depura\u00e7\u00e3o do WordPress<\/a><\/strong>:<\/p>\n\n\n\n

Erro fatal do PHP: Trait \"MemberPress\\GroundLevel\\Container\\Concerns\\InjectsDependencies\" n\u00e3o encontrado em \/home\/username\/public_html\/wp-content\/plugins\/memberpress\/app\/lib\/MeprAddonUpdates.php na linha 19<\/code><\/pre>\n\n\n\n
O WordPress tamb\u00e9m envia um e-mail sobre o erro cr\u00edtico para o endere\u00e7o de e-mail do administrador do site. Nesse e-mail, o mesmo erro aparece assim:<\/p>\n\n\n\n
Ocorreu um erro do tipo E_ERROR na linha 15 do arquivo \/home\/username\/public_html\/wp-content\/plugins\/memberpress\/app\/controllers\/MeprFeatureAddonCtrl.php. Mensagem de erro: Trait \"MemberPress\\GroundLevel\\Container\\Concerns\\InjectsDependencies\" n\u00e3o encontrado<\/code><\/pre>\n\n\n\n
O nome exato do arquivo, o n\u00famero da linha e o nome da caracter\u00edstica ou da classe podem variar de um site para outro. Todas as variantes do erro t\u00eam a mesma causa e a mesma solu\u00e7\u00e3o.<\/p>\n\n\n\n
Observa\u00e7\u00e3o:<\/strong> Uma mensagem de erro que menciona \u201cN\u00e3o \u00e9 poss\u00edvel resolver o par\u00e2metro\u201d<\/strong> tem uma causa diferente. Este documento n\u00e3o aborda esse erro. Nesse caso, entre em contato com o Equipe de suporte da MemberPress<\/a><\/strong> diretamente.<\/p>\n\n\n\n
O que causa o erro<\/a><\/h2>\n\n\n\n
A maioria dos servidores usa OPcache<\/a><\/strong>, um recurso do PHP que mant\u00e9m c\u00f3pias do c\u00f3digo do site na mem\u00f3ria. Isso ajuda as p\u00e1ginas a carregarem mais rapidamente, pois o servidor n\u00e3o precisa ler cada arquivo novamente a cada visita.<\/p>\n\n\n\n
Durante uma atualiza\u00e7\u00e3o, o MemberPress substitui seus arquivos no servidor. Em seguida, o WordPress solicita ao servidor que atualize as c\u00f3pias armazenadas. No entanto, algumas configura\u00e7\u00f5es de servidor bloqueiam ou ignoram essa atualiza\u00e7\u00e3o.<\/p>\n\n\n\n
Quando isso acontece, o servidor continua usando uma lista desatualizada dos arquivos do plugin. Os novos arquivos da atualiza\u00e7\u00e3o n\u00e3o constam nessa lista. Como resultado, o PHP n\u00e3o consegue encontr\u00e1-los, e o erro fatal \u00e9 exibido.<\/p>\n\n\n\n
Esse mesmo comportamento do servidor pode afetar qualquer atualiza\u00e7\u00e3o de plugin ou tema do WordPress. A solu\u00e7\u00e3o \u00e9 fazer com que o servidor carregue os novos arquivos.<\/p>\n\n\n\n
Observa\u00e7\u00e3o:<\/strong> Execu\u00e7\u00e3o das atualiza\u00e7\u00f5es WP-CLI<\/a><\/strong> tamb\u00e9m pode causar esse erro. A linha de comando e o servidor web utilizam caches distintos. A atualiza\u00e7\u00e3o renova um cache, enquanto o outro permanece desatualizado.<\/p>\n\n\n\n
Solu\u00e7\u00e3o 1: Atualizar a p\u00e1gina<\/a><\/h2>\n\n\n\n
Em muitos casos, o erro \u00e9 tempor\u00e1rio. O servidor atualiza seu cache automaticamente alguns minutos ap\u00f3s a atualiza\u00e7\u00e3o.<\/p>\n\n\n\n
Aguarde alguns minutos e, em seguida, atualize a p\u00e1gina. Se o erro persistir, passe para a pr\u00f3xima solu\u00e7\u00e3o.<\/p>\n\n\n\n
Solu\u00e7\u00e3o 2: Reinstalar a atualiza\u00e7\u00e3o MemberPress<\/a><\/h2>\n\n\n\n
A reinstala\u00e7\u00e3o do plug-in grava novamente todos os arquivos MemberPress no servidor. Na maioria dos casos, isso faz com que o servidor descarte as c\u00f3pias desatualizadas. Siga estas etapas:<\/p>\n\n\n\n
    \n
  1. Baixe o arquivo .zip mais recente do MemberPress<\/a><\/strong> do Downloads<\/strong> aba do seu Conta MemberPress<\/a><\/strong>.<\/li>\n\n\n\n
  2. Fa\u00e7a login em seu site e navegue at\u00e9 Painel > Plug-ins > Adicionar novo plug-in<\/strong>.<\/li>\n\n\n\n
  3. Clique no bot\u00e3o Plug-in de upload<\/strong> bot\u00e3o, clique Selecionar arquivo<\/strong>, e selecione o arquivo .zip baixado.<\/li>\n\n\n\n
  4. Clique em Instalar agora<\/strong>.<\/li>\n\n\n\n
  5. Na pr\u00f3xima p\u00e1gina, clique no bot\u00e3o Substituir atual por carregado<\/strong> bot\u00e3o.<\/li>\n<\/ol>\n\n\n\n
    Esse processo reinstala o plug-in sem afetar nenhum dado do MemberPress. O Atualiza\u00e7\u00e3o do MemberPress<\/a><\/strong> O documento descreve o processo de atualiza\u00e7\u00e3o manual com mais detalhes.<\/p>\n\n\n\n
    Observa\u00e7\u00e3o:<\/strong> O erro fatal pode bloquear o acesso ao painel do WordPress. Nesse caso, use o link do modo de recupera\u00e7\u00e3o que consta no e-mail de erro cr\u00edtico. Como alternativa, substitua o \/wp-content\/plugins\/memberpress\/<\/code><\/strong> virar a pasta FTP<\/a><\/strong> com a pasta do arquivo .zip baixado. Os usu\u00e1rios que n\u00e3o puderem usar o FTP podem acessar diretamente a solu\u00e7\u00e3o de provedor de hospedagem<\/a><\/strong>. O provedor pode corrigir o erro sem que seja necess\u00e1rio realizar nenhuma a\u00e7\u00e3o no site.<\/p>\n\n\n\n
    Verifique o site ap\u00f3s a reinstala\u00e7\u00e3o. Se o erro persistir, passe para a pr\u00f3xima solu\u00e7\u00e3o.<\/p>\n\n\n\n
    Solu\u00e7\u00e3o 3: Limpar o OPcache do servidor<\/a><\/h2>\n\n\n\n
    Em alguns servidores, a reinstala\u00e7\u00e3o dos arquivos n\u00e3o atualiza o cache. Nesse caso, \u00e9 necess\u00e1rio reiniciar o cache manualmente.<\/p>\n\n\n\n
    Muitos pain\u00e9is de controle de hospedagem incluem uma op\u00e7\u00e3o para limpar o cache do PHP ou reiniciar o PHP. O nome e a localiza\u00e7\u00e3o da op\u00e7\u00e3o dependem do provedor de hospedagem. Procure por op\u00e7\u00f5es com o nome \u201cLimpar o OPcache do PHP\u201d<\/strong>, \u201cLimpar o cache do PHP\u201d<\/strong>ou \u201cReiniciar o PHP\u201d<\/strong>. Reiniciar o PHP tamb\u00e9m limpa todo o cache.<\/p>\n\n\n\n
    Limpe o cache e, em seguida, atualize a p\u00e1gina. Se o erro persistir ou se essa op\u00e7\u00e3o n\u00e3o estiver dispon\u00edvel, entre em contato com o provedor de hospedagem.<\/p>\n\n\n\n
    Solu\u00e7\u00e3o 4: Entre em contato com o provedor de hospedagem<\/a><\/h2>\n\n\n\n
    O provedor de hospedagem pode reinicializar o cache diretamente no servidor. Essa solu\u00e7\u00e3o n\u00e3o requer nenhum procedimento t\u00e9cnico. Ela tamb\u00e9m funciona quando o erro fatal bloqueia o painel do WordPress.<\/p>\n\n\n\n
    O modelo de mensagem a seguir descreve o problema para a equipe de suporte da hospedagem:<\/p>\n\n\n\n
    Ol\u00e1,\n\nAp\u00f3s uma atualiza\u00e7\u00e3o de um plugin, meu site exibe um erro fatal do PHP informando que uma\ntra\u00e7o ou classe n\u00e3o foi encontrada. Os arquivos atualizados do plugin est\u00e3o presentes no\ndisco. No entanto, o OPcache est\u00e1 servindo c\u00f3pias em cache desatualizadas de alguns arquivos.\n\nVoc\u00eas poderiam, por favor, limpar o OPcache do PHP da minha conta ou reiniciar o PHP\n(PHP-FPM)?\n\nPor favor, verifique tamb\u00e9m se opcache.restrict_api ou\nopcache.validate_timestamps=0 est\u00e1 configurado no meu servidor. Essas configura\u00e7\u00f5es impedem\nque o WordPress atualize os arquivos em cache automaticamente durante as atualiza\u00e7\u00f5es\nde plugins. Ajust\u00e1-las evitaria esse problema em atualiza\u00e7\u00f5es futuras.\n\nObrigado.<\/code><\/pre>\n\n\n\n
    Depois que o provedor de hospedagem reiniciar o cache, o site carregar\u00e1 os novos arquivos do plugin e o erro desaparecer\u00e1. Se o erro persistir ap\u00f3s a reinicializa\u00e7\u00e3o do cache, entre em contato com o Equipe de suporte da MemberPress<\/a><\/strong> para obter mais ajuda.<\/p>\n\n\n\n
    O que normalmente n\u00e3o resolve esse erro<\/a><\/h2>\n\n\n\n
    O erro \u00e9 causado pelo cache PHP do servidor. Portanto, as etapas comuns de solu\u00e7\u00e3o de problemas a seguir geralmente n\u00e3o resolvem o problema:<\/p>\n\n\n\n
      \n
    • limpar o cache do navegador, j\u00e1 que o navegador n\u00e3o armazena o erro;<\/li>\n\n\n\n
    • limpar os plugins de cache de p\u00e1ginas (por exemplo, WP Rocket, W3 Total Cache), j\u00e1 que esses plugins armazenam p\u00e1ginas, e n\u00e3o arquivos PHP;<\/li>\n\n\n\n
    • limpar o cache do CDN (por exemplo, o Cloudflare), pelo mesmo motivo;<\/li>\n\n\n\n
    • desativar e reativar o MemberPress, j\u00e1 que isso n\u00e3o grava os arquivos do plug-in novamente;<\/li>\n\n\n\n
    • reparar ou restaurar o banco de dados, j\u00e1 que o banco de dados n\u00e3o \u00e9 a causa do erro.<\/li>\n<\/ul>\n\n\n\n
      Ignorar essas etapas economiza tempo e evita altera\u00e7\u00f5es desnecess\u00e1rias no site.<\/p>","protected":false},"excerpt":{"rendered":"
      After a MemberPress update, a website can crash and show a fatal PHP error. The error states that a trait or class within the MemberPress\\GroundLevel namespace was not found. The error comes from the server\u2019s cache, not from MemberPress itself. It does not indicate lost or damaged data. All memberships, members, and settings remain safe [\u2026]<\/p>\n","protected":false},"author":62252,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_strive_editorial_status":"not-started","_strive_copy_of":0,"inline_featured_image":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_genesis_hide_title":false,"_genesis_hide_breadcrumbs":false,"_genesis_hide_singular_image":false,"_genesis_hide_footer_widgets":false,"_genesis_custom_body_class":"","_genesis_custom_post_class":"","_genesis_layout":"","_FSMCFIC_featured_image_caption":"","_FSMCFIC_featured_image_nocaption":"","_FSMCFIC_featured_image_hide":"","_strive_checklists":"\"\"","_strive_active_checklist":"62291e2bb2422","footnotes":""},"ht-kb-category":[1287],"ht-kb-tag":[],"class_list":{"0":"post-81674","1":"ht_kb","2":"type-ht_kb","3":"status-publish","4":"format-standard","6":"ht_kb_category-licensing-and-plugin-issues","7":"entry"},"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t