Skip to main content

Rollback Process - WeChat

This guide provides step-by-step instructions for rolling back the WeChat Mini Program to a previous version when issues are discovered in production. Unlike other components, WeChat rollbacks require review and approval from WeChat, which can take 1-7 business days.

Prerequisites​

Before starting the rollback process, ensure you have:

  • Access to the WeChat Official Account Platform (https://mp.weixin.qq.com/)
  • Valid WeChat Official Account credentials with appropriate permissions
  • Knowledge of the version to rollback to
  • Understanding of the issues that require rollback
Important Timing Consideration

WeChat rollbacks require review and approval from WeChat, which typically takes 1-7 business days. This is not suitable for urgent rollbacks. Consider alternative solutions for critical issues that need immediate resolution.

Rollback Process​

Follow these steps to rollback the WeChat Mini Program to a previous version:

Step 1: Access WeChat Official Account Platform​

  1. Navigate to Platform

    • Open your web browser and go to WeChat Official Account Platform
    • Sign in with your WeChat account credentials
    • Ensure you have the necessary permissions to manage versions

  2. Verify Account Access

    • Confirm you're logged into the correct WeChat Official Account
    • Verify you have version management permissions
    • Check that you can access the Version Management section

Step 2: Navigate to Version Management​

  1. Open Version Management

    • In the platform menu, navigate to Version Management
    • Click on Version Management in the submenu
    • You will see a list of all uploaded versions

  2. Review Version History

    • Review the list of available versions
    • Check version numbers and upload dates
    • Review version notes to identify the target version
    • Verify the version you want to rollback to exists
Version Identification

Look for:

  • Version numbers (e.g., 1.0.0, 1.2.3)
  • Upload dates to identify when versions were deployed
  • Version notes that describe what was included in each version

Step 3: Select Target Version​

  1. Identify Stable Version

    • Review the version list to find the last known stable version
    • Check version notes to confirm it's the correct version
    • Verify the version was previously approved and published

  2. Select Version

    • Click on the version you want to rollback to
    • Review the version details to confirm it's the correct one
    • Note the version number and any relevant details
Version Compatibility

Ensure the target version is compatible with:

  • Current backend API versions
  • Database schema (if applicable)
  • External service integrations
  • WeChat platform requirements

Step 4: Submit for Review​

  1. Initiate Rollback

    • Select the version you want to rollback to
    • Click Submit for Review button
    • This will submit the version for WeChat's review process

  2. Complete Submission Form

    • Fill in all required information in the submission form
    • Provide a clear reason for the rollback (if requested)
    • Add any additional details requested by WeChat
    • Review all information before submitting

  3. Confirm Submission

    • Review all settings and information carefully
    • Click Confirm to submit the rollback request
    • You will receive a confirmation that the submission was successful
Review Process

After submission:

  • WeChat will review your rollback request
  • Review typically takes 1-7 business days
  • You will be notified when the review is complete
  • The version will be published automatically after approval

Step 5: Monitor Review Status​

  1. Track Review Progress

    • Check the Version Management section regularly
    • Monitor the review status of your submission
    • Look for any notifications or messages from WeChat

  2. Respond to Requests

    • If WeChat requests additional information, provide it promptly
    • Address any compliance issues if raised
    • Follow up on any questions or concerns
Review Rejection

If WeChat rejects your rollback request:

  • Review the feedback provided by WeChat
  • Address any compliance or policy issues
  • Resubmit after making necessary corrections
  • Consider alternative solutions if rollback is not possible

Step 6: Verify Rollback After Approval​

After WeChat approves and publishes the rollback:

  1. Test the Application

    • Test the WeChat Mini Program functionality
    • Verify all features work as expected
    • Check for any issues or errors
    • Test on different devices if possible

  2. Monitor User Feedback

    • Monitor user feedback and reports
    • Check analytics for any anomalies
    • Review error logs and crash reports
    • Verify the rollback resolved the issues

  3. Verify Integration

    • Test integration with backend APIs
    • Verify data synchronization
    • Check external service integrations
    • Ensure all connections are working correctly

Alternative Solutions for Urgent Issues​

Since WeChat rollbacks require review time, consider these alternatives for urgent issues:

  1. Hotfix Deployment

    • Deploy a hotfix version with the necessary fixes
    • This may be faster than waiting for rollback approval
    • Still requires WeChat review, but may be prioritized

  2. Feature Flags

    • Use feature flags to disable problematic features
    • This can be done without a new version submission
    • Allows quick mitigation of issues

  3. Backend Fixes

    • If issues are backend-related, fix them on the backend
    • No WeChat review required for backend changes
    • Faster resolution for API or data issues

  4. Temporary Workarounds

    • Implement temporary workarounds in the current version
    • Deploy a quick fix version if possible
    • Plan for proper rollback or fix after

Post-Rollback Actions​

After a successful rollback:

  1. Document the Rollback

    • Record the reason for rollback
    • Document the version rolled back from and to
    • Note the review timeline and any issues encountered
    • Document any WeChat feedback or requirements

  2. Communicate with Team

    • Notify the team about the rollback
    • Share the reason, target version, and timeline
    • Update relevant documentation

  3. Investigate Root Cause

    • Analyze why the deployment caused issues
    • Review code changes between versions
    • Plan fixes for the problematic version

  4. Plan Forward

    • Decide on next steps (hotfix, re-deployment, etc.)
    • Schedule fixes for the rolled-back version
    • Update deployment procedures if needed
    • Consider improving testing to prevent similar issues

Troubleshooting​

Common Issues​

Cannot access Version Management

  • Verify you have the necessary permissions
  • Check that you're logged into the correct account
  • Ensure your account has version management access
  • Contact account administrator if needed

Version not found in list

  • Verify the version was previously uploaded
  • Check that you're looking in the correct account
  • Ensure the version wasn't deleted
  • Review version history and archives

Submission form errors

  • Verify all required fields are filled
  • Check that information is in the correct format
  • Ensure you're using supported characters
  • Review WeChat's submission guidelines

Review rejection

  • Review WeChat's feedback carefully
  • Address compliance issues mentioned
  • Fix any policy violations
  • Resubmit after corrections

Rollback doesn't resolve issues

  • Verify you rolled back to the correct version
  • Check if issues are backend-related (not WeChat-specific)
  • Review integration points and external services
  • Consider if issues existed in the target version

Performance issues after rollback

  • Check if performance issues are version-specific
  • Verify backend API performance
  • Review database and external service performance
  • Check for resource constraints

Best Practices​

  1. Maintain Version History - Keep detailed records of all uploaded versions
  2. Document Version Notes - Always include clear notes when uploading versions
  3. Test Before Upload - Thoroughly test versions before uploading to WeChat
  4. Plan for Rollback Time - Account for 1-7 business days review time in planning
  5. Have Backup Plans - Have alternative solutions ready for urgent issues
  6. Monitor After Rollback - Closely monitor the application after rollback approval
  7. Learn from Issues - Use rollback experiences to improve deployment processes
  8. Communicate Early - Notify stakeholders about rollback timelines