如何排除故障 - ImportError：部署 django 时无法导入设置“mysite.settings”？

Question

根据 apache 部署说明，我已经部署了 django 应用程序并与 apache 和 mod_python 完美配合。但由于我稍微改变了项目结构，我无法让它工作。无论我尝试什么，我都会不断收到以下页面：

MOD_PYTHON ERROR

ProcessId:      27841
Interpreter:    '127.0.0.1'

ServerName:     '127.0.0.1'
DocumentRoot:   '/var/www'

URI:            '/myapp/'
Location:       '/myapp/'
Directory:      None
Filename:       '/var/www/myapp'
PathInfo:       '/'

Phase:          'PythonHandler'
Handler:        'django.core.handlers.modpython'

Traceback (most recent call last):

  File "/usr/lib/python2.6/dist-packages/mod_python/importer.py", line 1537, in HandlerDispatch
    default=default_handler, arg=req, silent=hlist.silent)

  File "/usr/lib/python2.6/dist-packages/mod_python/importer.py", line 1229, in _process_target
    result = _execute_target(config, req, object, arg)

  File "/usr/lib/python2.6/dist-packages/mod_python/importer.py", line 1128, in _execute_target
    result = object(arg)

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/core/handlers/modpython.py", line 212, in handler
    return ModPythonHandler()(req)

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/core/handlers/modpython.py", line 174, in __call__
    self.load_middleware()

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/core/handlers/base.py", line 39, in load_middleware
    for middleware_path in settings.MIDDLEWARE_CLASSES:

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/utils/functional.py", line 276, in __getattr__
    self._setup()

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/conf/__init__.py", line 42, in _setup
    self._wrapped = Settings(settings_module)

  File "/usr/local/lib/python2.6/dist-packages/Django-1.3.1-py2.6.egg/django/conf/__init__.py", line 89, in __init__
    raise ImportError("Could not import settings '%s' (Is it on sys.path?): %s" % (self.SETTINGS_MODULE, e))

ImportError: Could not import settings 'settings' (Is it on sys.path?): No module named settings

阅读各种线程，问题可能是以下之一

• apache 配置文件不正确
• sys.path 不正确
• 对任何文件或目录的权限不正确
• 我的 django 站点代码中的错误

有什么办法可以缩小问题的范围吗？例如，有没有办法找出出错时的 sys.path 是什么？有任何日志文件可以帮助我吗？有没有办法区分“找不到文件”和“没有读取文件的权限”？我想更科学地处理解决方案，而不是在偶然发现解决方案之前尝试随机的事情。

此问题与：Mod_python error: ImportError: Could not import settings 不同。我特意寻求帮助缩小可能解决方案的方法，而不是解决方案本身。

Answer 1

好的，我自己解决了这个问题，所以我会回答我自己的问题。 我发现没有 apache 日志或任何其他信息来源来确定导致导入错误的确切原因。所以我在下面分享我的方法，作为一种更“理性”的方法，希望我可以为某人节省几个令人沮丧的随机变化的时间。

为了记录，这是我使用的 apache 配置。

<Location "/mysite/">
    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE mysite_django.settings
    PythonOption django.root /mysite
    PythonDebug On
    PythonPath "['/home/mysite/prg/mysite/mysite_django', '/home/mysite/prg/mysite'] + sys.path"
</Location>

我在服务器上创建了一个用户“mysite”，django settings.py 位于（有点多余的命名）位置/home/mysite/prg/mysite/mysite_django/settings.py。 我打开一个到服务器的 ssh 通道。在这种情况下，我使用非常有用的 screen 实用程序在用户之间快速切换（但第二个 ssh 通道也可以工作）

screen

按 Ctrl-A、Ctrl-C 创建一个新屏幕。 现在重要的是要像 apache 一样查看权限，所以我切换到运行 apache 的用户，即 debian 系统上的 www-data：

sudo -i -u www-data

我打算自己尝试从python环境导入settings.py：

python

>>> import os, sys
>>> print sys.path
... result omitted ...

这显然应该为您提供没有任何“mysite”目录的标准 sys.path，因为我们正在运行普通的 python。所以我修改了 sys.path 如下。我直接从 apache 配置中复制粘贴，以避免拼写错误：

>>> sys.path = ['/home/mysite/prg/mysite/mysite_django', '/home/mysite/prg/mysite'] + sys.path
>>> import mysite_django.settings
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: No module named mysite_django.settings

正如预期的那样，我在浏览器中加载我的网站时遇到了同样的错误。所以我可以在 python 环境中复制问题，这是一件好事。显然，构建路径应该由系统路径条目“/home/mysite/prg/mysite”加上请求的导入路径“mysite_django/settings.py”组成。那为什么不导入呢？让我们确保给定的系统路径条目确实存在

>>> os.path.exists (sys.path[0])
False

它不存在？奇怪的。

>>> os.path.exists ('/home')
True
>>> os.path.exists ('/home/mysite')
True
>>> os.path.exists ('/home/mysite/prg/')
True
>>> os.path.exists ('/home/mysite/prg/mysite')
True
>>> os.path.exists ('/home/mysite/prg/mysite/mysite_django')
False

这里我意识到mysite_django的权限有问题。可能是我所做的所有随机更改的遗留物。但实际上，问题出在上面的目录 mysite 中，因为它试图从那里读取目录列表。我用 Ctrl-A、Ctrl-N 切换到超级用户屏幕，并使用chmod 设置 mysite 的权限，使其与上一个成功的目录相同：

$ ls -la /home/mysite/prg
total 12
drwxr-xr-x 3 mysite mysite 4096 2011-11-08 11:24 .
drwxr-xr-x 7 mysite mysite 4096 2011-11-08 14:56 ..
drwxr-xr-- 6 mysite mysite 4096 2011-11-08 11:35 mysite
$ chmod o+x /home/mysite/prg/mysite/
$ ls -la /home/mysite/prg
total 12
drwxr-xr-x 3 mysite mysite 4096 2011-11-08 11:24 .
drwxr-xr-x 7 mysite mysite 4096 2011-11-08 14:56 ..
drwxr-xr-x 6 mysite mysite 4096 2011-11-08 11:35 mysite

使用 Ctrl-A、Ctrl-N 切换回 www-data 屏幕：

>>> os.path.exists ('/home/mysite/prg/mysite/mysite_django')
True
>>> os.path.exists ('/home/mysite/prg/mysite/mysite_django/settings.py')
True

现在进行最后的测试

>>> import mysite_django.settings
>>>

耶！成功 我们甚至可以更进一步测试 django 是否可以加载

>>> from django.core.management import setup_environ
>>> setup_environ(mysite_django.settings)
'/home/mysite/prg/mysite/mysite_django'

此时该网站在我的浏览器中再次运行。

通过执行这些步骤，您至少可以确保：

• 用户 www-data 的 settings.py 没有权限问题
• 您的 apache 配置的 PythonPath 设置没有错误
• 导入 settings.py 时没有运行时错误

Answer 2

对于我的 Django 1.5 和 mod_wsgi，我是这样解决的：

httpd.conf：

WSGIScriptAlias /mysite "/var/www/html/mysite/mysite/wsgi.py"
WSGIPythonPath  "/var/www/html/mysite/mysite"
<Directory "/var/www/html/mysite/mysite">
    Order deny,allow
    Allow from all
</Directory>

wsgi.py:
sys.path.append(path) 让 mysite.settings 知道

import os
import sys                                              #new
path = '/var/www/html/mysite'                           #new
if path not in sys.path:                                #new
    sys.path.append(path)                               #new

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "mysite.settings")
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

另一件事，为了避免如下错误

Premature end of script headers: wsgi.py

你需要从 httpd.conf 中移除 cgi 配置

AddHandler cgi-script .py