本地无法启动Python服务器：执行python manage.py runserver报错

Hey there! Let's troubleshoot that python manage.py runserver error together—this is super common with Django projects, so we'll get you up and running in no time.

1. Verify Your Virtual Environment #

• First, make sure you’re working in the correct virtual environment for your project. If you’re using venv, activate it:
  • Windows: venv\Scripts\activate
  • macOS/Linux: source venv/bin/activate
• If you haven’t set up a virtual environment yet, create one first with python -m venv venv, activate it, then install all project dependencies with pip install -r requirements.txt.

2. Fix Missing Dependencies #

• A huge number of these errors come from missing packages like Django. Run pip list to check if Django is installed. If not, install it directly:

  pip install django
  

• Always use your project’s requirements.txt to ensure all required packages are installed: pip install -r requirements.txt.

3. Check Your Working Directory #

• Double-check that you’re running the command from the exact folder where manage.py is located. If you’re in a parent or subfolder, navigate to the correct directory first with cd path/to/your/project.

4. Resolve Port Conflicts #

• The default port 8000 might be occupied by another app. Try running the server on a different port:

  python manage.py runserver 8080
  

• To kill the process using port 8000:
  • Windows: Open Command Prompt as admin, run netstat -ano | findstr :8000 to get the PID, then taskkill /PID <PID> /F.
  • macOS/Linux: Run lsof -i :8000 to find the PID, then kill -9 <PID>.

5. Fix Django Configuration Issues #

• If you get an error related to settings.py, ensure the DJANGO_SETTINGS_MODULE environment variable is set correctly:
  • Either run the command with settings specified: python manage.py runserver --settings=your_project_name.settings
  • Or set the environment variable:
    • Windows: set DJANGO_SETTINGS_MODULE=your_project_name.settings
    • macOS/Linux: export DJANGO_SETTINGS_MODULE=your_project_name.settings
• Also, scan settings.py for syntax errors—even a missing comma or typo can crash the server.

6. Troubleshoot Database Connections #

• If the error links to your database, verify the DATABASES configuration in settings.py:
  • For SQLite, make sure the NAME path points to a valid file (it will be created automatically if it doesn’t exist).
  • For PostgreSQL/MySQL, confirm the database server is running, and your credentials (username, password, host) are correct.

If none of these fixes work, share the exact error message you’re seeing—specific text like "ModuleNotFoundError" or "ImproperlyConfigured" will help zero in on the problem even faster!

内容的提问来源于stack exchange，提问作者Manosh Chalasani