如何用GitHub Actions测试aiogram机器人的构建可行性？

针对你遇到的机器人运行会进入无限循环的问题，可以通过以下几种方式在GitHub Actions中验证应用能否正常构建，无需让机器人持续运行：

1. 静态代码与语法检查 #

直接用代码分析工具检查代码的语法错误、潜在问题，确保代码能被Python正常解析，这是最基础的验证步骤：

• 安装flake8：pip install flake8
• 运行检查命令：

  flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
  

  这个命令会专门检测致命语法错误和无法运行的代码，如果没有报错，说明代码的语法层面没问题。

2. 依赖安装与导入验证 #

验证依赖是否正确安装，且核心模块能正常导入：

• 用pip check检查依赖是否有冲突：

  pip check
  

• 编写一个简单的导入测试脚本（比如test_imports.py），内容如下：

  from aiogram import Bot, Dispatcher
  from aiogram.types import Message, CallbackQuery
  # 导入你项目中使用的其他核心模块
  
  print("All imports successful!")
  

  在Actions中运行这个脚本：python test_imports.py，如果能正常输出内容，说明依赖安装正确，模块可正常导入。

3. 单元测试验证核心逻辑 #

把机器人的业务逻辑（比如命令处理、数据处理、回调函数等）拆分为独立的单元，编写测试用例，用pytest运行，无需启动整个机器人：

• 安装pytest：pip install pytest
• 编写测试用例，比如测试一个命令处理函数：

  # tests/test_commands.py
  from aiogram.types import Message, User
  from your_bot.handlers import start_command
  
  def test_start_command():
      # 模拟Message对象
      mock_user = User(id=123, is_bot=False, first_name="Test")
      mock_message = Message(message_id=1, chat=None, from_user=mock_user, text="/start")
      # 调用处理函数
      result = start_command(mock_message)
      # 断言返回结果符合预期
      assert result.text == "欢迎使用机器人！"
  

• 在Actions中运行测试：pytest tests/ -v，如果所有测试通过，说明核心业务逻辑正常。

4. 模拟机器人初始化（不启动循环） #

修改你的机器人启动脚本，通过环境变量判断是否在CI环境（GitHub Actions会自动设置CI=true），仅完成初始化流程就退出，不启动轮询：

# main.py
import os
import asyncio
from aiogram import Bot, Dispatcher
from your_bot.routes import router

async def main():
    # 初始化Bot和Dispatcher
    bot = Bot(token=os.getenv("BOT_TOKEN"))
    dp = Dispatcher()
    # 加载路由、中间件等
    dp.include_router(router)
    
    # 仅在非CI环境启动轮询
    if not os.getenv("CI"):
        await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

在GitHub Actions中运行这个脚本时，会完成Bot初始化、路由加载等流程后自动退出，验证这些环节是否正常（比如token是否有效、路由是否注册成功）。

GitHub Actions工作流示例 #

把以上步骤整合到一个工作流文件（.github/workflows/build-test.yml）中：

name: Bot Build Verification
on: [push, pull_request]

jobs:
  verify-build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"  # 匹配你的项目Python版本
      
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
          pip install flake8 pytest
      
      - name: Static code check
        run: flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
      
      - name: Verify imports
        run: python test_imports.py
      
      - name: Run unit tests
        run: pytest tests/ -v
      
      - name: Test bot initialization
        env:
          BOT_TOKEN: ${{ secrets.BOT_TOKEN }}  # 从GitHub Secrets中获取token
          CI: true
        run: python main.py

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