Hey there! That libGL error is super common when working with OpenCV—especially in headless environments (like servers or Docker containers) or when your system's OpenGL libraries are missing. Let's go through a few reliable fixes, even if the python3-opencv install didn't work for you:

1. Install the System-Level OpenGL Library #

The libGL.so.1 file is part of your system's core graphics libraries, not the Python OpenCV package itself. Run this to install the missing dependency:

sudo apt-get update && sudo apt-get install -y libgl1-mesa-glx

This package provides the exact shared library your Python environment is looking for.

2. Resolve Conflicts Between System and Pip Installations #

Sometimes mixing the system-provided python3-opencv and pip-installed OpenCV packages causes conflicts. Let's clean up and start fresh:

• First, remove the system package completely:

  sudo apt-get remove --purge -y python3-opencv
  

• Uninstall any existing OpenCV packages from pip:

  pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless
  

• Install the right version for your environment:
  • For desktop environments (with a GUI):

    pip install opencv-python
    

  • For headless environments (servers/Docker, no GUI):

    pip install opencv-python-headless
    

    The headless version skips GUI-related dependencies, which avoids issues like missing libGL.

3. Verify and Fix Library Paths #

If the library exists on your system but Python can't find it, check if its directory is in your LD_LIBRARY_PATH:

• First, locate where libGL.so.1 is stored:

  find /usr -name libGL.so.1
  

  You'll usually get a path like /usr/lib/x86_64-linux-gnu/libGL.so.1.
• Add that directory to your library path temporarily:

  export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
  

• Try importing cv2 again. To make this change permanent, add the export line to your ~/.bashrc or ~/.profile file.

If none of these work, double-check that you're using the correct Python environment (e.g., not mixing a virtual environment with the system Python).

内容的提问来源于stack exchange，提问作者Paul Engelbert