The CSV won't map, or errors out
How you'll know: QuickBooks complains about the format, or the amounts end up in the description.
Fix: Trim the file to three columns (Date, Description, Amount) or four (Date, Description, Credit, Debit). Take the word "amount" out of the Credit and Debit headers, blank out cells that only hold a zero, keep one date format throughout, and give the weekday its own column if your bank glued it onto the date.
The upload stalls on a long statement
How you'll know: A year of a busy account fails partway, or never finishes.
Fix: It's over the 1,000-line or 350 KB limit. Download it again in quarters, or months, and upload each piece.
Everything shows up twice
How you'll know: After a second upload, or after the bank feed reconnected, the review list holds pairs of identical rows.
Fix: Exclude the copies before you add anything. If doubles were already added, delete one of each pair, then reconcile to prove the balance is right again.
Card purchases came in as money received
How you'll know: Charges show as deposits, or the card balance grows the wrong way.
Fix: The file went to a bank account, or the bank exported the signs reversed. Undo those rows, then upload again into the credit card account. Our credit card payments guide covers what each line should be.