problemas comuns

Home > Problemas comuns

Problemas comuns

Em uma frase: a mensagem que apareceu, a causa e o que fazer. Use Ctrl+F com um pedaço da mensagem.

Instalação e compilação

Mensagem / sintoma	Causa	O que fazer
File not found: 'RALServer.dcu' / Can't find unit RALServer	o RAL não está no library path (Delphi) ou no projeto (Lazarus)	Delphi, passo 6; Lazarus: requisito pascalral
File not found: 'IdHTTP.dcu', mormot.*, ZConnection	a dependência do motor não está instalada	Dependências
janela "faltam os pacotes IndySystem/IndyCore/IndyProtocols" ao instalar	normal	clique OK
Cannot load package ... It contains unit X, which is also contained in package Y	pacote compilado com src no search path	tire o src do search path do pacote e recompile
componente sumiu da paleta após um erro	o Delphi desativou o pacote	Component > Install Packages, marque de novo
F2039 Could not create output file ... .bpl	o pacote está carregado na IDE	feche os projetos ou a IDE
MSB6003: ... "dcc" could not be run (msbuild)	library path gigante na máquina	compile pela IDE
"ponto de entrada não encontrado" ao abrir o Delphi	várias versões do Delphi na máquina	Múltiplas versões do Delphi
uma unit removida do RAL ainda "aparece" (Lazarus)	.ppu velho em lib	lazbuild -B no pacote, ou Clean up and Build
Property X does not exist ao abrir um formulário	formulário de versão anterior (ex.: 1.2 na 1.3)	Ignore; veja Atualizar de versão
Runtime error 232 no Linux (Lazarus)	falta cthreads no início do uses	{$IFDEF UNIX}cthreads,{$ENDIF} como primeira unit

Servidor

Mensagem / sintoma	Causa	O que fazer
Could not bind socket / Address already in use	a porta está em uso	outra porta, ou feche o outro programa
outro computador não conecta, mas localhost funciona	firewall	libere a porta
404	o endereço não bate com nenhuma rota	confira Route e o Domain do módulo
405	método fora de AllowedMethods	acrescente o método (Rotas)
401	falta login, ou a senha não bate	Autenticação; SkipAuth para rota pública
403 depois de várias tentativas	força bruta ou flood bloqueou o IP	espere, ou ponha o IP na lista branca (Segurança)
413	pedido maior que MaxRequestSize	aumente o limite
415 / 406	compressão pedida que o servidor não tem	RALCompressZLib (ou brotli/zstd) no uses
429 (DBWare)	o pool de conexões do banco esgotou	PoolOptions.MaxSize/WaitTimeout (DBWare)
503 com Retry-After	a fila do TRALConcurrencyPlugin encheu (1.3 🚧)	MaxConcurrent/MaxQueueWait
500 com o texto de uma exceção	erro dentro da rota	corrija; em produção, HideErrorDetails
servidor 1.3 não comprime / não manda CORS	sem plugin	Plugins
o navegador acusa CORS	AllowOrigin vazio (padrão na 1.2 🚧)	informe a origem (Segurança)
WebModule responde 404 em tudo	DocumentRoot vazio (1.2 🚧)	Servir arquivos
Could not load SSL library	DLLs do OpenSSL 1.0.2 (Indy)	HTTPS no motor
cliente: (12175) A security error occurred contra servidor Indy	Indy oferece só TLS 1.0	SSLVersions com sslvTLSv1_2
PFXImportCertStore ... CRYPT_E_BAD_ENCODE	mORMot2 no Windows quer .pfx	HTTPS no motor
emHttpSysAddUrl, código 5	URL não reservada no http.sys	netsh http add urlacl como administrador (HTTP/2)
This version of TLS is not supported by the lib.	libsagui sem TLS	baixe a versão com TLS

Cliente

Mensagem / sintoma	Causa	O que fazer
Engine X not found: the unit that registers it is not in the uses	a unit do motor não está no uses	RALIndyClient, RALnetHTTPClient... (O cliente)
a tela trava durante o pedido	chamada sem ebMultiThread	passe ebMultiThread
Access violation depois do pedido	resposta liberada duas vezes, ou guardada do evento	na forma "esperar", libere uma vez; no evento, não guarde
NetworkOnMainThreadException (Android)	pedido na thread principal	ebMultiThread
o corpo chega ilegível	compressão sem a unit	RALCompressZLib no uses
emCertRejected	o pin ou OnValidateServerCert recusou	confira a impressão digital (HTTPS no cliente)
emCertPinUnsupported	o motor não lê impressão digital naquela plataforma	troque de motor (Indy, OkHttp, MsQuic)
emCertNotInspectable	mORMot2 no Windows sem OpenSSL	OpenSslInitialize
emCertRequiresTLS	SSL.Required ou pin com URL http://	use https://
emHTTP2Unsupported	rhv2 num motor sem HTTP/2	netHTTP/OkHttp, ou rhvDefault
Encrypted data failed integrity check	chave AES diferente nos dois lados	mesma chave e configuração (Criptografia)

Ainda não resolveu?

• Procure nas Issues.
• Pergunte no Discord ou Telegram (links na Home), com a mensagem exata, a versão do RAL, do Delphi/Lazarus e o motor.