GitHub Actions部署docs文件夹至Hostinger服务器失败排查

以下是针对你遇到的GitHub Action未触发FTP部署问题的排查方向：

1. 优先检查Workflow文件路径 #

GitHub要求Action工作流文件必须放在**仓库根目录下的.github/workflows/（复数形式）**目录中，你当前的路径是.github/workflow/main.yml（单数workflow），这会导致GitHub无法识别该工作流，自然不会触发执行。

• 解决：将目录名从workflow改为workflows，确保文件路径为.github/workflows/main.yml。

2. 验证GitHub Secrets配置 #

• 确认已在仓库的「Settings > Secrets and variables > Actions」中添加FTP_USERNAME和FTP_PASSWORD两个密钥，且值与Hostinger提供的FTP账号、密码完全一致（无多余空格或拼写错误）。
• 如果密钥未配置或配置错误，即使工作流触发，也会因认证失败导致部署失败，但如果连触发都没发生，先重点排查路径问题。

3. 核对FTP服务器信息 #

Hostinger的FTP服务器地址通常不是自定义的子域名ftp.descsimp.online，建议登录Hostinger面板查看FTP详情：

• 确认正确的FTP服务器地址（一般为ftp.你的主域名.com或服务器IP）。
• 检查端口：默认FTP端口为21，若使用SFTP则端口为22，需在Action中添加对应参数：

  with:
    # 若用SFTP
    protocol: sftp
    port: 22
  

4. 确认触发条件是否满足 #

• 你的工作流配置为仅在main分支推送时触发，确认你推送的代码确实提交到了main分支，而非master或其他分支。
• 检查GitHub仓库的提交记录，确保推送操作已成功同步到远程仓库。

5. 查看Action运行日志 #

• 若路径修正后仍无执行，前往仓库的「Actions」页面，查看是否有工作流运行记录：
  • 若有记录但失败，查看日志中的错误信息（如连接超时、目录不存在、认证失败等）定位问题。
  • 若无任何记录，说明工作流文件仍未被GitHub识别，继续检查路径或文件格式。

6. 考虑Action版本兼容性 #

你使用的SamKirkland/FTP-Deploy-Action@4.3.4是旧版本，该Action已停止维护，建议升级到最新稳定版（如@v4.3.5），或更换其他活跃维护的FTP部署Action，避免版本兼容问题。

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