Troubleshooting PrestaShop 9.0.2 Update Failures: Deprecation Warnings and Official Fixes

PrestaShop 9.0.2 Update Issues: A Community Troubleshooting Effort

A PrestaShop forum thread highlights the challenges users face when updating to version 9.0.2, specifically encountering a generic "something went wrong" error during the update process. The original poster, joelabine, details their attempts to resolve the issue, including checking PHP error logs, clearing the var/dev folder, and trying various approaches without success.

The thread reveals a common pain point in PrestaShop updates: seemingly random errors that halt the process. While one user initially suggests avoiding minor version updates due to potential risks, others offer more practical solutions.

Solutions and Workarounds

Fabry suggests a multi-step approach:

• Ensure all modules are updated before attempting the PrestaShop core update.
• Reinstall the Autoupgrade module.
• Manually load the XML file and PrestaShop 9.0.2 ZIP archive into the /admin/autoupgrade/download folder. The user clarifies that the XML file is available in the PrestaShop Classic repository releases on GitHub.
• Unzip the archive manually to save processing time during the update.
• Ensure the shop is in maintenance mode and the cache is cleared.

However, the original poster was still facing issues. The root cause was eventually identified as deprecation warnings being returned in AJAX requests. The solution involved modifying the php.ini file to suppress these warnings:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED

This configuration change effectively hides the deprecation warnings, allowing the update process to proceed without interruption. The user also linked to a relevant issue on the PrestaShop Autoupgrade module's GitHub repository, providing further context.

The Official Fix

Another user, mcaldex, pointed to the official fix available as a pull request on the Autoupgrade module's GitHub repository:

https://github.com/PrestaShop/autoupgrade/pull/1584

This fix is scheduled for release in version 7.6.0 of the Autoupgrade module. Applying this patch is the recommended long-term solution.

Key Takeaways

• Deprecation warnings can cause update failures: Hidden deprecation warnings in AJAX requests can unexpectedly halt the PrestaShop update process.
• Temporary workaround: Suppressing deprecation warnings in php.ini can allow the update to proceed.
• Official solution: Apply the official fix from the Autoupgrade module's GitHub repository or wait for version 7.6.0.
• Module Compatibility: Ensure all modules are updated to their latest versions before attempting a PrestaShop core update.

This thread highlights the importance of community collaboration in troubleshooting PrestaShop issues and provides valuable insights into resolving update problems caused by deprecation warnings.