Data de publicação: 07/05/2026
🎯 Objetivo
Orientar sobre a nova validação de bloqueio no uso de bibliotecas (libs) distintas no mesmo ambiente do Protheus, explicando o que mudou, como o controle funciona, quais os impactos nas rotinas de atualização e quais cuidados devem ser adotados na administração do ambiente. (TDN TOTVS Developer Network)
🧩 Ambiente
Framework Microsiga Protheus – Configurador | Gestão de Acessos.
A página técnica da TOTVS informa que essa orientação foi modificada em 19/01/2026. (TDN TOTVS Developer Network)
🔎 Visão geral
A partir da versão 20260119, o sistema passou a permitir o acesso ao mesmo ambiente utilizando somente uma única versão de biblioteca (lib). Segundo a TOTVS, essa validação foi implementada para garantir mais estabilidade e segurança, evitando falhas e inconsistências que podem ocorrer quando conexões concorrentes usam libs diferentes no mesmo ambiente. (TDN TOTVS Developer Network)
Na prática, isso elimina o uso misto de versões de lib em produção no mesmo ambiente lógico. Com isso, processos que antes dependiam de troca de biblioteca com usuários conectados passam a exigir mais controle operacional. Essa leitura decorre diretamente do bloqueio de versão e do impacto declarado pela TOTVS nas atualizações “a quente”. (TDN TOTVS Developer Network)
⚙️ O que mudou
A TOTVS descreve que, a cada acesso, o sistema verifica se a lib utilizada é a mesma que já foi registrada em acessos concorrentes. Se a versão for diferente da que já está em uso no ambiente, o sistema exibe uma mensagem de aviso, informando a divergência e identificando a conexão que está utilizando a outra biblioteca. (TDN TOTVS Developer Network)
Em resumo, o ambiente passa a operar com um lock de versão, impedindo a convivência simultânea de bibliotecas diferentes. (TDN TOTVS Developer Network)
🛠️ Como funciona o bloqueio
1. Validação no momento do acesso
Sempre que uma nova conexão é aberta, o sistema compara a lib da conexão atual com a lib já registrada nas conexões concorrentes do mesmo ambiente. (TDN TOTVS Developer Network)
2. Identificação de divergência
Se houver diferença entre as versões, o sistema não trata isso como uma situação permitida. Em vez disso, apresenta uma mensagem de alerta com o detalhamento da divergência encontrada. (TDN TOTVS Developer Network)
3. Proteção da estabilidade do ambiente
O objetivo desse controle é impedir que o ambiente continue operando com combinações inconsistentes de bibliotecas, reduzindo risco de comportamento imprevisível no ERP. (TDN TOTVS Developer Network)
🔐 Papel da SpecialKey e do lock por DBAccess
A TOTVS destaca que a chave specialkey afeta o lock realizado no ambiente. Por isso, é importante que cada ambiente possua sua própria specialkey configurada. (TDN TOTVS Developer Network)
A documentação também informa que, quando é utilizado o controle de lock pelo DBAccess, o lock passa a ser exclusivo por banco de dados e, nesse cenário, a specialkey deixa de ser utilizada, o que ajuda a evitar problemas com essa validação. (TDN TOTVS Developer Network)
⚠️ Impacto nas rotinas de atualização
Esse é o ponto mais importante da mudança: a TOTVS informa expressamente que, com essa nova validação, não será mais possível aplicar libs “a quente”, ou seja, com o sistema em pleno funcionamento. (TDN TOTVS Developer Network)
Isso muda diretamente a forma de atualizar ambientes Protheus. Atualizações de lib agora exigem tratamento controlado, evitando que conexões antigas continuem usando a biblioteca anterior enquanto novas conexões passem a usar a nova.
✅ Como atualizar corretamente após essa mudança
Segundo a TOTVS, para aplicar uma nova lib sem conflito de versões, devem ser seguidas estas orientações:
1. Fazer a aplicação em ambiente dedicado ou de forma exclusiva
A aplicação da nova lib deve ocorrer em um ambiente dedicado ou em condição de uso exclusivo, sem concorrência com outras conexões usando versão anterior. (TDN TOTVS Developer Network)
2. Reiniciar todos os servidores do ambiente
Após a aplicação da nova biblioteca, é obrigatório reiniciar todos os servidores do ambiente para que a atualização seja reconhecida corretamente e não haja conflito com versões antigas ainda carregadas. (TDN TOTVS Developer Network)
📌 Resultado esperado
Com esse controle ativo, o ambiente passa a aceitar somente conexões que utilizem a mesma versão de lib já registrada, reduzindo inconsistências operacionais e tornando o processo de atualização mais seguro e previsível. Em contrapartida, atualizações de biblioteca passam a exigir parada planejada ou aplicação em ambiente isolado. (TDN TOTVS Developer Network)
💡 Boas práticas
manter uma estratégia formal de atualização de lib com janela de manutenção;
evitar qualquer tentativa de troca de lib com usuários conectados;
configurar uma specialkey própria por ambiente quando esse modelo de lock estiver em uso;
avaliar o uso do lock pelo DBAccess para reduzir dependência da specialkey;
reiniciar todos os serviços do ambiente após atualização de lib;
testar a nova biblioteca primeiro em homologação antes da aplicação em produção.
Essas recomendações são compatíveis com o comportamento e com os impactos operacionais descritos pela TOTVS. (TDN TOTVS Developer Network)
❓ FAQ
1. O que mudou a partir da versão 20260119?
O sistema passou a permitir acesso ao mesmo ambiente apenas com uma única versão de lib por vez. (TDN TOTVS Developer Network)
2. O que acontece se houver acesso com lib diferente?
O sistema identifica a divergência e exibe uma mensagem de aviso com o detalhamento da conexão que está usando versão diferente. (TDN TOTVS Developer Network)
3. Ainda é possível trocar lib “a quente”?
Não. A TOTVS informa que, com essa validação, a aplicação de libs “a quente” não é mais possível. (TDN TOTVS Developer Network)
4. Como deve ser feita a atualização de lib agora?
A nova lib deve ser aplicada em ambiente dedicado ou de forma exclusiva, seguida de reinício de todos os servidores do ambiente. (TDN TOTVS Developer Network)
5. A specialkey ainda é importante?
Sim. A TOTVS informa que a specialkey afeta o lock do ambiente, por isso cada ambiente deve possuir sua própria configuração quando esse modelo estiver em uso. (TDN TOTVS Developer Network)
6. O que muda se o lock for controlado pelo DBAccess?
Nesse caso, o lock passa a ser exclusivo por banco de dados e a specialkey não é mais utilizada, o que evita problemas relacionados a essa validação. (TDN TOTVS Developer Network)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”