使用Selenium编写Django测试遇TypeError错误求解决方案

这个错误我之前帮别人排查过好几次，主要是几个常见原因，咱们一步步来解决：

1. 核心原因：版本不兼容或环境变量异常 #

这个报错本质是Selenium在启动Firefox驱动时，读取到了非字符串类型的环境变量，或者驱动与浏览器/selenium版本不匹配导致的初始化异常。

解决方案一：匹配Selenium、Geckodriver和Firefox版本 #

Firefox的驱动（Geckodriver）对版本兼容性要求很严格：

• 如果用的是Selenium 4.x，需要搭配Geckodriver 0.30+，同时Firefox浏览器版本要在90以上；
• 如果是Selenium 3.x，对应Geckodriver 0.29及以下，Firefox版本也要对应旧版。

你可以直接指定Geckodriver的路径（如果它不在系统PATH里），用Selenium 4的新写法更规范：

from selenium.webdriver.firefox.service import Service

def setUp(self):
    # 替换成你本地Geckodriver的实际路径
    service = Service('/Users/yourname/Downloads/geckodriver')
    self.driver = webdriver.Firefox(service=service)

解决方案二：过滤环境变量中的非字符串值 #

有时候系统环境变量里会混入非字符串类型的变量，导致Selenium初始化失败。可以在测试代码开头加一段过滤逻辑：

import os

# 在setUp之前或者文件开头执行，确保所有环境变量都是字符串
os.environ = {k: str(v) for k, v in os.environ.items()}

解决方案三：修复tearDown的小bug #

你原代码里的self.driver.quit少了括号！这会导致浏览器进程无法正常关闭，长期积累可能引发各种奇怪问题，一定要改成：

def tearDown(self):
    self.driver.quit()

修正后的完整测试代码 #

import unittest
import os
from selenium import webdriver
from selenium.webdriver.firefox.service import Service

class TestSignup(unittest.TestCase):
    def setUp(self):
        # 过滤环境变量，避免非字符串值引发错误
        os.environ = {k: str(v) for k, v in os.environ.items()}
        # 初始化Firefox驱动，指定Geckodriver路径
        service = Service('/usr/local/bin/geckodriver')  # 替换成你的实际路径
        self.driver = webdriver.Firefox(service=service)

    def test_signup_fire(self):
        self.driver.get("http://localhost:8000/add/")
        self.driver.find_element_by_id('id_title').send_keys("test title")
        self.driver.find_element_by_id('id_body').send_keys("test body")
        self.driver.find_element_by_id('submit').click()
        self.assertIn("http://localhost:8000/", self.driver.current_url)

    def tearDown(self):
        self.driver.quit()

if __name__ == '__main__':
    unittest.main()

额外排查方向 #

如果上面的方法都没用，可以试试：

• 升级Selenium到最新版：pip install --upgrade selenium
• 换ChromeDriver测试，看看是不是Firefox特定的兼容性问题，Chrome的驱动兼容性通常更友好。

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