Erros, características e problemas

O QGIS é um projeto movido em sua grande parte por voluntariado, e é o trabalho de um time dedicado de desenvolvedores, documentadores, tradutores e apoiadores. Apesar dos esforços para lançar um QGIS sem erros, ainda podem haver muitos problemas. Se você encontrar algum erro ou gostaria que novas funcionalidades fossem desenvolvidas, por favor, comunique!

Each part of the QGIS Project has a dedicated place where issues (feature requests or bugs) can be reported, managed and discussed. You’ll find issues related to:

Para questões, por favor contate a Listas de e-mail.

Reporting issues on QGIS applications

QGIS applications (QGIS Desktop, QGIS Browser and QGIS Server) issues are available in Redmine. In order to submit or comment a report, you need an OSGeo account and login. To get started, first Create an OSGeo account. It may require some time to have your account approved.


On the OSGeo userid page you can find more information about the OSGeo id we use. For example to change your password or email address, or to reset your lost password.

Before reporting an issue

Before filing an issue, review the currently open issues to make sure that you aren’t creating a duplicate. If you have additional information on an issue, you can add it to the existing ticket. Third party plugins might also cause problems. If you have installed any, you should also verify that the problem is still reproducible without them. Please don’t report multiple unrelated bugs in a single bug report.

Steps to create a report

Once your account is validated and you are logged in, a New Issue tab is available in the menu bar. Select it .

Informação importante necessária quando abre um bilhete:

  • Tracker - choose the ticket type from the drop-down list: Bug, Feature (new feature request)
  • Assunto - uma pequena descrição do problema

  • Description - Provide a full description of the problem including steps to repeat it; if you think the bug could be related to a certain platform version or dependencies package version (GDAL, OGR, GEOS etc) include that as well. If your QGIS crashes if might be useful to include a backtrace (see below). A very important thing when reporting a bug is to boil down a minimum example that is needed to reproduce the bug. The chances of a bug being addressed in a timely manner is directly related to the speed with which the developer can reproduce the bug. If you make that hard for the developer, chances are the bug will be given up on or ignored for quite a while.
  • Priority - provide an estimate of the severity of the problem:
    • Baixa: um problema que não afeta o uso do QGIS

    • Normal: the default value, applicable to most bugs and nearly all feature requests,
    • High: a bug which has a major effect on the usability of a package,
    • or Severe/Regression: a bug that makes QGIS totally unusable, causes serious data loss or a regression from a previous QGIS version
  • Category - Choose the aspect of the application that is most closely associated with the problem
  • Milestone - If this issue affects a particular Milestone in the project choose it from the drop-down list
  • Versão - Versão do QGIS onde ocorre o problema

  • Plataforma - Escolha a plataforma que você está usando

Before sending the report, please check the formatting of your report by clicking on “Preview”. Please avoid editing existing reports, if not for typos. Better add further comments in any other case.

A criação de um registo de chamadas

If you have a crash it might be useful to include a backtrace as the bug might be not reproducible on another machine.

On Linux QGIS automatically tries to use gdb to connect to the crashing process to produce a backtrace. But some distributions disable the possiblity to connect debuggers to a running processes. In that case gdb only produces a rather useless message like:

QGIS died on signal 11Could not attach to process.
If your uid matches the uid of the target process,
check the setting of /proc/sys/kernel/yama/ptrace_scope, or try
again as the root user.
For more details, see /etc/sysctl.d/10-ptrace.conf
ptrace: Operation not permitted.
No thread selected
No stack.
gdb returned 0
Aborted (core dumped)

In that case you should reenable that option by setting kernel.yama.ptrace_scope to 0 in /etc/sysctl.d/10-ptrace.conf (or /etc/sysctl.conf or some other file in /etc/sysctl.d/) and run sysctl -p as root. When you reproduce the crash after that, a backtrace will be printed instead.

If you cannot reproduce the crash, there should still be a core dump in the current directory, that can be analysed after the process has already terminated. It’s called core (on some systems a dot and the process id is append to the filename).

On some distributions the creation of core dumps is also disabled. In the event that you just get Aborted instead of Aborted (core dumped) when the crash occurs. Then you need to run ulimit -c unlimited before starting QGIS. You can also include that in your .profile, so that it’s always enabled when you login.

To produce a backtrace from the core file, start gdb /path/to/the/qgis/binary core. The binary is usually /usr/bin/qgis or /usr/bin/qgis.bin on Debian with the GRASS plugin installed. In gdb you run bt which will produce the backtrace.

Log output on Windows

The nightly build in OSGeo4W (package qgis-dev) is built with debugging output, that you can view with DebugView. If the problem is not easy to reproduce the output might shed some light about where QGIS crashes.

Erros nos complementos

Plugin bugs must be opened in their respective bug tracking system. Check first if the plugin is listed in the plugin overview. If so, click on the plugin name then click “New issue”.

Most of the plugins are published in the official QGIS Plugins repository. If the plugin is available, you’ll find in its presentation a link to its bug tracker. Otherwise, consult the plugin documentation to find the address of the relevant bug tracking system or a developer to contact.

Reporting issues on QGIS web site or documentation

QGIS project provides an active web site and a rich documentation. Despite our efforts, if you find an out of date information, a wrong or unclear statement or miss a valuable information, please feel free to report it.

The main sources of these documents are hosted and managed in GitHub repositories so in order to report bugs or submit patches, you need a GitHub account and login.

Para começar, primeiro Crie uma conta GitHub.

Then, choose the appropriate repository:

Check if the issue you’d like to report is not already entered.

Clique Novo Erro, digite um título e uma descrição clara para seu problema.

When you’re finished, click Submit new issue.


A Fix me link is provided at the bottom of any page of the web site to help you directly improve this page and submit pull request.

This option is also available in the footer of the documentation.

Submitting a Patch

In addition to issue report, you can help to fix issues. Fixing issues is done in GitHub through pull requests. You need to fork the repository you want to contribute to and submit pull requests at:

You can find a few guidelines that will help you to easily get your patches and pull requests into QGIS projects at Submitting Patches and Pull Requests. And more widely, You may need to read Acesso GIT.