Introduction

Python ConnectionError when network connection fails. This guide provides step-by-step diagnosis and resolution.

Symptoms

Typical error output:

bash
Traceback (most recent call last):
  File "app.py", line X
Error: Python operation failed
Check stack trace for details

Common Causes

  1. 1.Module not installed or incorrect Python environment
  2. 2.Variable or attribute not defined or None type
  3. 3.Invalid data format or missing key/index
  4. 4.Syntax or indentation error in code

Step-by-Step Fix

Step 1: Check Current State

bash
# Run Python with verbose output
python -v app.py
# Check installed packages
pip list
# Verify Python path
python -c "import sys; print(sys.path)"

Step 2: Identify Root Cause

bash
# Check Python version
python --version
# Verify module installation
pip show numpy
# Check environment variables
echo $PYTHONPATH

Step 3: Apply Primary Fix

bash
# Primary fix: Install missing module
pip install numpy
# Verify installation
python -c "import numpy; print(numpy.__version__)"
# Run application
python app.py

Step 4: Apply Alternative Fix

bash
# Alternative: Check environment
# List installed packages
pip freeze | grep numpy
# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
pip install -r requirements.txt

Step 5: Verify the Fix

bash
python -c "import numpy; print('OK')"
python app.py
# Should run without errors

Common Pitfalls

  • Using wrong Python version for package
  • Not activating virtual environment
  • Mixing pip and conda installations
  • Forgetting to add module to requirements.txt

Best Practices

  • Use virtual environments for isolation
  • Keep requirements.txt updated
  • Pin package versions for reproducibility
  • Use pip freeze to verify installations
  • Module Not Found
  • AttributeError
  • ImportError
  • TypeError