Base de Conhecimento

Erro 1055 MySQL: only_full_group_by, como resolver

  • mysql, erro 1055, only_full_group_by, group by, sql_mode, any_value
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Erro 1055 MySQL: only_full_group_by, como resolver

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.

Esta resposta lhe foi útil?

Artigos Relacionados