Troubleshooting

How to fix problems with LinkAutocorrect

  1. Check the error log of your webserver for PHP warnings, uncaught exceptions, and permission issues.
    Apache2: /var/log/apache2/
    Nginx: /var/log/nginx/
    LiteSpeed: /usr/local/lsws/logs/
    The origin of your problem is most likely a simple configuration issue.
  2. If there are no relevant entries in the error log, open the configuration file and set debug to true. Then intentionally visit an incorrect URL on your website like https://example.com/typo. Replace example.com with the domain of your website. You should see a page similar to the following:

    Carefully read the debug output. Common issues include:
    • The request path was blocked by a rule from the installed blocklists. Edit the installed blocklists to match your desired behavior.
    • The list of pages to compare the input with is empty or contains too many entries, causing a significant slowdown in processing speed.
    • Failed to connect to the SQL database.
    • One or more correction methods were accidentally deactivated.
  3. Confirm that your webserver routes 404 events to the 404handler.php file. The Web Server Config page has instructions on how to set this up.
  4. Verify that the PHP process has read access to the directories you want to scan. Missing permissions will prevent the candidate path list from being built correctly.
  5. Settings like blockipv4, blockipv6, and prot_blockedpaths_processing are very powerful. Double-check that they are set according to your needs.
  6. Make sure that protection options like IP rate limiting are not configured to be overly aggressive. Temporarily set thresholds to -1 or disable the relevant options to determine whether they are suppressing valid traffic.
  7. Check if the correction log has filled up the entire available disk space and delete older entries if necessary.
  8. Clear expired cache entries using the admin panel.
  9. Check that you have the correct PHP version installed on your webserver. Visit the System requirements page for more info.
  10. Test the similarity and autocomplete engines individually. Set cmpltMode to disabled to isolate similarity-based corrections, then re-enable it and temporarily disable simMode to evaluate autocomplete-only behavior.

If you need further assistance, visit the Contact us page.