在Render.com上使用Flask-Selenium时非默认端点返回502错误

问题重现 #

在Render.com部署Flask应用时出现以下异常：

• 根路由/搭配Selenium功能运行正常
• 非默认路由（如/t）调用含Selenium的接口时返回502错误
• 不带Selenium的非默认路由（如/hello）可正常返回内容
• 本地环境运行无问题，部署使用构建命令gunicorn main:app

含Selenium的非默认路由代码：

from selenium import webdriver
from selenium.webdriver.common.by import By
from flask import Flask

app = Flask(__name__)

@app.route("/t")
def st():
    chrome_options = webdriver.ChromeOptions()
    chrome_options.add_argument("--headless=new")
    # chrome_options.add_argument("--disable-dev-shm-usage")
    # chrome_options.add_argument("--no-sandbox")
    # chrome_options.add_argument("--disable-gpu")
    browser = webdriver.Chrome(options=chrome_options)
    browser.get("http://www.example.com")
    button = browser.find_element(By.TAG_NAME, "a")
    button.click()
    bpt = browser.find_element(By.TAG_NAME, "p").text
    browser.quit()
    return bpt

正常运行的无Selenium路由代码：

@app.route("/hello")
def sy():
    return "hello"

可能原因及解决方案 #

1. 缺失Linux容器环境下Chrome必需参数 #

Render的运行环境是Linux容器，你注释掉的几个参数是Chrome在该环境下正常启动的关键：

• --no-sandbox：禁用沙箱模式，Linux容器环境下必需
• --disable-dev-shm-usage：避免容器内共享内存不足导致Chrome崩溃
• --disable-gpu：无GPU环境下禁用GPU加速

修改后的Chrome配置：

chrome_options = webdriver.ChromeOptions()
chrome_options.add_argument("--headless=new")
chrome_options.add_argument("--disable-dev-shm-usage")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-gpu")
# 可选：如果Render环境找不到Chrome，指定二进制路径
# chrome_options.binary_location = "/usr/bin/chromium-browser"

2. 请求超时触发502 #

Render的Web服务默认请求超时为10秒，Selenium启动Chrome、加载页面、执行交互的总时间很容易超过这个阈值，尤其是非默认路由首次调用时，Chrome启动耗时更长。

解决方法：

• 优化Selenium执行流程：用WebDriverWait代替直接查找元素，避免无意义的等待
• 调整Render请求超时：在应用设置的"Advanced"选项中，把"Request Timeout"调至30秒或更长
• 复用Chrome实例：在Flask启动时初始化一个Chrome实例，避免每次请求都重新启动（注意：多worker场景下每个worker需单独初始化）

示例单worker场景下复用Chrome：

from selenium import webdriver
from selenium.webdriver.common.by import By
from flask import Flask

app = Flask(__name__)

# 应用启动时初始化Chrome
chrome_options = webdriver.ChromeOptions()
chrome_options.add_argument("--headless=new")
chrome_options.add_argument("--disable-dev-shm-usage")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-gpu")
browser = webdriver.Chrome(options=chrome_options)

@app.route("/t")
def st():
    browser.get("http://www.example.com")
    button = browser.find_element(By.TAG_NAME, "a")
    button.click()
    bpt = browser.find_element(By.TAG_NAME, "p").text
    return bpt

# 应用关闭时退出Chrome
@app.teardown_appcontext
def teardown_browser(exception):
    browser.quit()

3. Gunicorn配置不合理 #

默认的gunicorn main:app使用同步worker，当请求被Selenium阻塞时，可能导致后续请求无法处理从而触发502。

调整gunicorn启动命令，增加worker数量并设置超时：

gunicorn --workers=2 --timeout=30 main:app

• --workers=2：根据Render实例规格调整，避免资源耗尽
• --timeout=30：和Render的请求超时保持一致

4. 查看Render日志定位具体错误 #

502只是网关层的提示，真正的错误原因需要看应用日志：

1. 进入Render应用控制台
2. 切换到"Logs"标签页
3. 查看/t请求对应的报错信息，比如Chrome启动失败、元素查找超时等，再针对性解决

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