Erro 1055 MySQL: only_full_group_by, como resolver
Entenda o erro 1055 do MySQL, como ver o sql_mode e quatro soluções em ordem de segurança, de corrigir a consulta até tirar o ONLY_FULL_GROUP_BY.
Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Erro 1055 MySQL: only_full_group_by, como resolver Arte: Eleven Host
O erro 1055 MySQL, com a mensagem incompatible with sql_mode=only_full_group_by, aparece quando um SELECT com GROUP BY pede uma coluna que não está agrupada nem agregada. A saída mais segura é corrigir a consulta; mexer no sql_mode fica como último recurso.
Abaixo estão a mensagem, o motivo, como consultar o sql_mode e quatro correções em ordem de segurança. Os nomes de tabela e de coluna dos exemplos são fictícios.
O que a mensagem do erro 1055 diz
Na referência de erros do MySQL 8.4, o número 1055 tem o símbolo ER_WRONG_FIELD_WITH_GROUP, o SQLSTATE 42000 e a mensagem de catálogo abaixo, que é o nome oficial do erro:
'%s' isn't in GROUP BY
Na tela, a mensagem vem mais longa. O manual do MySQL 8.4 mostra este texto, para uma consulta de exemplo do próprio manual:
ERROR 1055 (42000): Expression #2 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'mydb.t.address' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by
No erro 1055, o MySQL recusa a consulta porque não sabe qual valor da coluna devolver para cada grupo.
Por que o erro 1055 acontece
Segundo o manual do MySQL 8.4, o ONLY_FULL_GROUP_BY vem ligado por padrão no 8.4. Com ele ligado, o MySQL rejeita consultas em que o SELECT, o HAVING ou o ORDER BY citam colunas não agregadas que não estão no GROUP BY e não dependem funcionalmente delas.
Um exemplo de tabela e de consulta, com nomes fictícios:
CREATE TABLE pedidos (
id INT PRIMARY KEY,
cliente_id INT NOT NULL,
cliente_nome VARCHAR(100),
valor DECIMAL(10,2)
);
Agora uma consulta que, no MySQL 8.4, dá o erro 1055:
SELECT cliente_id, cliente_nome, SUM(valor) FROM pedidos GROUP BY cliente_id;
A coluna cliente_nome não está no GROUP BY e não é agregada. Para o MySQL, um mesmo cliente_id poderia ter nomes diferentes em linhas diferentes, e ele não tem como escolher um.
Existe também uma versão do problema sem GROUP BY. O manual explica que, se a consulta tem função de agregação e não tem GROUP BY, ela não pode ter coluna não agregada no SELECT, no HAVING ou no ORDER BY. O exemplo do manual é este:
SELECT name, MAX(age) FROM t;
Nesse caso, o manual mostra o erro 1140, e não o 1055.
Como ver o sql_mode
O sql_mode existe em dois níveis: o global, que vale para as conexões novas, e o da sessão, que vale só para a conexão atual. Para ver os dois, o manual traz estas consultas:
SELECT @@GLOBAL.sql_mode;
SELECT @@SESSION.sql_mode;
Se o ONLY_FULL_GROUP_BY aparece na lista, ele está ligado naquele nível. No MySQL 8.4, o padrão do sql_mode inclui ONLY_FULL_GROUP_BY, STRICT_TRANS_TABLES, NO_ZERO_IN_DATE, NO_ZERO_DATE, ERROR_FOR_DIVISION_BY_ZERO e NO_ENGINE_SUBSTITUTION.
Solução 1: corrigir a consulta
A primeira escolha é ajustar o comando. Há dois caminhos: pôr a coluna no GROUP BY ou agregá-la. Com a tabela de exemplo, a primeira forma é:
SELECT cliente_id, cliente_nome, SUM(valor) FROM pedidos GROUP BY cliente_id, cliente_nome;
Atenção: isso muda o agrupamento. Agora há um grupo para cada par de cliente e nome, e a consulta pode devolver mais linhas do que antes. A segunda forma agrega a coluna, escolhendo um valor de forma explícita:
SELECT cliente_id, MAX(cliente_nome), SUM(valor) FROM pedidos GROUP BY cliente_id;
Use MAX() ou MIN() quando fizer sentido para o dado. Se o erro vier junto de outro, como coluna que não existe, veja o guia Erro 1054 MySQL: Unknown column, como resolver.
Solução 2: agrupar pela chave primária
O manual explica que o MySQL detecta dependência funcional. Quando você agrupa por uma chave primária, ou por uma coluna UNIQUE que seja NOT NULL, as outras colunas da mesma tabela passam a depender do grupo, e o MySQL as aceita. O manual descreve a consulta como válida se name for chave primária da tabela ou uma coluna única e NOT NULL.
O índice UNIQUE só vale se a coluna não aceitar NULL. Um índice único que permite NULL admite vários NULL, e a unicidade se perde. Por isso o manual diz que a técnica não serve se NULL precisa ser um valor válido da coluna.
O manual dá um exemplo com junção, agrupando pela chave primária da tabela country e lendo o nome da mesma tabela:
SELECT co.Name, COUNT(*)
FROM countrylanguage cl, country co
WHERE cl.CountryCode = co.Code
GROUP BY co.Code;
As quatro linhas formam um único comando. Na tabela de exemplo, agrupar pelo id faria as outras colunas passarem, mas o grupo passaria a ser cada pedido, e não cada cliente. Use essa técnica quando o agrupamento que você quer já for pela chave.
Está atrás de um banco de dados na nuvem? 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Abrir a loja de bancos
Solução 3: ANY_VALUE()
A função ANY_VALUE() serve para os casos em que o MySQL recusa uma consulta que você sabe que é válida, por razões que ele não consegue determinar. O manual esclarece que ela não é uma função de agregação, como SUM() ou COUNT(): ela apenas suprime o teste de não determinismo. Um exemplo com a tabela fictícia:
SELECT cliente_id, ANY_VALUE(cliente_nome), SUM(valor) FROM pedidos GROUP BY cliente_id;
O manual lembra que isso é útil se você não se importa com qual valor da coluna não agregada é escolhido para cada grupo.
O aviso sobre valor arbitrário
Se os valores do grupo forem diferentes, o servidor devolve um deles, sem critério. O manual chama isso de não determinístico e diz que provavelmente não é o que você quer. Também avisa que a escolha do valor não pode ser influenciada por um ORDER BY. Use o ANY_VALUE() quando você não se importar com qual valor sai.
Solução 4: tirar só o ONLY_FULL_GROUP_BY
É o último recurso. O manual afirma que desligar o ONLY_FULL_GROUP_BY equivale a usar ANY_VALUE() com o modo ligado, com o servidor livre para escolher um valor de cada grupo. Ele diz que isso é útil principalmente quando, por alguma propriedade dos dados, os valores de cada coluna não agrupada são iguais em cada grupo.
Recomendamos não zerar o sql_mode: um valor vazio tira também os modos estritos, como o STRICT_TRANS_TABLES. Tire apenas o ONLY_FULL_GROUP_BY e mantenha o resto da lista.
Só na sessão
Para mudar só a conexão atual, copie a lista que o SELECT @@SESSION.sql_mode; mostrou e grave de novo sem o ONLY_FULL_GROUP_BY. Um exemplo, supondo que a sua lista seja o padrão do MySQL 8.4:
SET SESSION sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';
Segundo o manual, mudar a variável de sessão afeta só o cliente atual.
No servidor inteiro
O comando para o nível global é parecido, e o manual diz que ele exige o privilégio SYSTEM_VARIABLES_ADMIN (ou o SUPER, que está marcado como obsoleto) e afeta as conexões que se conectarem a partir daquele momento. Quem já está conectado continua com o modo anterior. Um exemplo, com a mesma lista:
SET GLOBAL sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';
Essa mudança vale enquanto o servidor estiver rodando. Para ela continuar depois de um reinício, o valor precisa estar no arquivo de configuração.
No arquivo de configuração
O manual indica a opção sql-mode="modes" em um arquivo de opções, como o my.cnf no Unix ou o my.ini no Windows, com os modos separados por vírgula. Um exemplo, com a lista do padrão do MySQL 8.4 sem o ONLY_FULL_GROUP_BY:
[mysqld]
sql-mode="STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION"
Depois de salvar, reinicie o serviço do banco para valer.
Cuidados antes de mudar o sql_mode do servidor
- Tabelas particionadas. O manual avisa que mudar o modo SQL depois de criar e preencher tabelas particionadas pode causar mudanças grandes no comportamento delas e levar a perda ou corrupção de dados. Ele recomenda fortemente não mudar o modo depois de criar tabelas com particionamento definido pelo usuário.
- Réplicas. Ao replicar tabelas particionadas, modos diferentes na origem e na réplica também podem causar problemas. A orientação do manual é usar o mesmo modo nos dois.
MariaDB e o erro 1055
Segundo a documentação do MariaDB, o padrão do sql_mode é STRICT_TRANS_TABLES, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER e NO_ENGINE_SUBSTITUTION. Ou seja, o ONLY_FULL_GROUP_BY não vem ligado por padrão no MariaDB. Quando ligado, ele impede selecionar colunas que não estão no GROUP BY, a menos que passem por uma função de agregação como COUNT() ou MAX().
Isso explica por que um sistema que funcionava no MariaDB pode passar a dar o erro 1055 ao ser migrado para o MySQL 8.x. A página do MariaDB também indica que o SET GLOBAL lá exige o privilégio SUPER. Para consultar os dois valores no MariaDB, o comando é SELECT @@SQL_MODE, @@GLOBAL.SQL_MODE;.
Erros parecidos: 1140 e 3065
O 1140 tem o símbolo ER_MIX_OF_GROUP_FUNC_AND_FIELDS e o SQLSTATE 42000. É o caso da consulta com agregação e sem GROUP BY, como o SELECT name, MAX(age) FROM t; do manual. A correção segue a mesma lógica: agregar a coluna, agrupar ou usar ANY_VALUE().
O 3065 tem o símbolo ER_FIELD_IN_ORDER_NOT_SELECT e o SQLSTATE HY000. Ele trata de uma coluna do ORDER BY que não está na lista do SELECT. O manual também diz que uma consulta com DISTINCT e ORDER BY é rejeitada quando uma expressão do ORDER BY não está na lista do SELECT. O exemplo do manual é SELECT DISTINCT c1, c2 FROM t ORDER BY c3;.
Para outros erros do MySQL, veja os guias Erro 1364 MySQL: campo sem valor padrão, como resolver e Erro 1406 MySQL: Data too long for column, como resolver.
Resumo das soluções
A ordem de segurança é corrigir a consulta, agrupar pela chave primária, usar ANY_VALUE() e, só no fim, tirar o ONLY_FULL_GROUP_BY.
Vai comparar opções de servidor virtual? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos
Perguntas frequentes
O que significa o erro 1055 no MySQL?
Que a consulta pede uma coluna que não está no GROUP BY nem agregada, com o ONLY_FULL_GROUP_BY ligado. O MySQL recusa porque não sabe qual valor da coluna devolver.
O ONLY_FULL_GROUP_BY vem ligado por padrão?
No MySQL 8.4, sim. No MariaDB, segundo a documentação atual, o padrão do sql_mode não inclui esse modo.
Posso desligar o ONLY_FULL_GROUP_BY sem risco?
Não é a primeira opção. Com ele desligado, o servidor escolhe um valor de cada grupo, e esse valor não é determinístico quando os valores são diferentes. Corrija a consulta primeiro e, se precisar mudar o servidor, mantenha os outros modos da lista.
O ANY_VALUE() é uma função de agregação?
Não. Segundo o manual, ela apenas suprime o teste de não determinismo, e o valor devolvido é um dos valores do grupo.
Agrupar pela chave primária resolve?
Resolve quando as colunas lidas são da mesma tabela. A coluna UNIQUE também vale, desde que seja NOT NULL.