目录
osTicket 用户登录失败，建议按下面顺序查看。最先看 osTicket 系统日志，但普通的“用户名或密码错误”不一定会记录详细原因。
一、查看 osTicket 系统日志
管理员登录后台：
管理面板（Admin Panel） → 仪表盘（Dashboard） → 系统日志（System Logs）
这里会记录 PHP 错误、数据库错误、插件异常、OAuth/LDAP 异常等。
排查期间可以临时调整日志级别：
管理面板 → 设置（Settings） → 系统（System） → 默认日志级别（Default Log Level） → Debug
然后让用户重新登录一次，再刷新系统日志。排查完成后建议恢复为 Error 或 Warn，避免产生大量日志。(docs.osticket.com)
二、注意：密码错误通常不会显示具体原因
osTicket 的用户登录代码为了安全，会统一返回：
Invalid username or password - Please try again! 用户名或密码无效，请重试！
因此即使真实原因是“账号不存在”“密码错误”“认证后端不匹配”，页面上也可能只显示统一提示，不会明确告诉你是哪一种。CSRF Token 异常则可能直接返回 HTTP 400。(GitHub)
所以还需要检查用户账户状态。
三、检查用户账号状态
进入：
代理面板（Agent Panel） → 用户（Users） → 用户目录（User Directory） → 找到对应用户 → 管理账户（Manage Account） → 管理访问（Manage Access）
重点检查：
- 用户是否已经注册为正式账户，而不只是普通访客用户
- 邮箱是否已经完成激活确认
- 账号是否被锁定
- 是否被要求重置密码
- 登录用户名是否正确
- 使用的是“本地认证”还是 OAuth、LDAP 等外部认证
- 必要时由管理员重新设置密码
只有已经注册并激活的用户，才能使用用户名和密码登录并查看全部工单。(docs.osticket.com)
四、如果是运维专员/管理员登录失败
如果失败的是后台工作人员账号，即：
/scp/login.php
检查：
管理面板 → 专员/代理（Agents） → 找到对应账号
重点查看：
- 账号是否启用
- 是否因为连续输错密码被锁定
- 密码是否过期
- 是否启用了登录 IP 绑定
- 是否配置了错误的认证后端
- 是否要求双因素认证
- 2FA 是否失效
2FA 导致无法登录时，管理员可以进入账号页面执行：
Reset 2FA 重置双因素认证
osTicket 支持配置最大失败次数、锁定策略、密码过期及 IP 绑定等登录限制。(docs.osticket.com)
五、查看服务器 PHP 和网站错误日志
如果登录后出现空白页、500 错误、反复跳回登录页面、HTTP 400，重点看 PHP 和 Web 服务器日志。osTicket 官方也建议在系统日志不足时查看 PHP error_log 和 Web 服务器 error.log。(docs.osticket.com)
你之前的服务器目录像是宝塔环境，可以先执行：
# 查看网站错误日志 tail -f /www/wwwlogs/你的域名.error.log # 查看网站访问日志 tail -f /www/wwwlogs/你的域名.log
查询 PHP 实际错误日志配置：
php --ini php -i | grep -E "error_log|log_errors|display_errors"
宝塔不同 PHP 版本还可以检查：
grep -R "^error_log" /www/server/php/*/etc/php.ini
查看 PHP-FPM 日志，具体版本号按实际修改：
tail -f /www/server/php/82/var/log/php-fpm.log
排查时先执行：
tail -f /www/wwwlogs/你的域名.error.log
保持窗口打开，再让用户登录一次，通常能立即看到对应错误。
六、后台完全无法进入时查询数据库日志
osTicket 的系统日志通常保存在带有表前缀的 syslog 表中。默认前缀一般是 ost_：
SHOW TABLES LIKE '%syslog%';
找到实际表名后查询：
SELECT * FROM ost_syslog ORDER BY log_id DESC LIMIT 100;
如果你的表前缀不是 ost_，需要换成实际前缀。
最有效的排查顺序
1. Admin Panel → Dashboard → System Logs 2. 将日志级别临时改为 Debug 3. 检查用户是否注册、激活或被锁定 4. 管理员直接重置该用户密码 5. 查看网站 error.log 和 PHP-FPM 日志 6. 如果使用 OAuth/LDAP，再检查对应插件和认证服务器
对于普通用户登录失败，最常见的是：用户只是工单联系人但没有注册账户、邮箱没有激活、账号被锁定，或者用户把邮箱当成用户名登录但实际设置了其他用户名。