Django runscript报错：找不到有效脚本模块问题求助

遇到过一模一样的坑！先给你捋几个最可能的排查方向，亲测有用：

1. 先改命令：去掉.py后缀！ #

这是最容易踩的低级错误——runscript执行脚本时不需要加.py扩展名。你现在输入的是：

python manage.py runscript myscriptname.py

赶紧改成：

python manage.py runscript myscriptname

工具会自动识别对应脚本文件，加后缀反而会让它把myscriptname.py当成模块名去搜索，自然找不到。

2. 确认脚本的存放路径是否合规 #

runscript对脚本位置有严格要求：

• 必须放在任意一个已注册app的**scripts文件夹**里（注意是复数s，不是script）
• 这个scripts文件夹必须包含空的__init__.py文件，让Python识别它为合法模块

正确的项目结构应该是这样：

你的项目/
├── 某个app/
│   ├── scripts/
│   │   ├── __init__.py
│   │   └── myscriptname.py
└── manage.py

3. 检查django_extensions的配置 #

runscript是django-extensions提供的功能，不是Django原生工具：

• 先确认settings.py的INSTALLED_APPS里有没有添加django_extensions
• 如果刚装完django-extensions，可以试试重启终端或者重新激活虚拟环境（如果用了的话），确保模块路径生效

4. 用-v2参数排查搜索路径 #

执行带详细日志的命令：

python manage.py runscript -v2 myscriptname

看输出里的Looking for scripts in部分，确认你的scripts文件夹是否在搜索列表里。如果没出现，说明你的app没被正确识别，或者Python路径有问题，可以在manage.py开头加几行强制添加路径：

import sys
import os
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

5. 验证run函数的正确性 #

哪怕是测试脚本，也要严格符合规则：

• 函数名必须是小写的run，不能是Run/RUN
• 必须接受*args参数，哪怕你用不到，比如：

  def run(*args):
      print "hello"
  

  少了*args会被判定为无效模块。

6. 清理Python字节码缓存 #

Ubuntu下有时候.pyc文件会导致模块识别异常，执行命令删除所有缓存文件：

find . -name "*.pyc" -delete

然后再重新运行脚本试试。

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